doctrine:mapping:import 常失败因类型映射缺失、表名大小写/下划线不兼容、database_url 指向错误库、未指定 --em 参数；推荐先用 doctrine:mapping:convert --from-database 导出 YAML 再手动修正后转实体。
doctrine:mapping:import 是从现有数据库生成实体类的核心命令，但直接跑它大概率失败——因为 Doctrine 默认不识别你表里的 ENUM、TINYINT、自定义类型，也不处理字段名含下划线或大小写混用的情况。
为什么 doctrine:mapping:import 常报错或生成空类？
常见现象是命令执行后没输出、生成的 .orm.xml 或 .php 文件为空，或提示 Table not found。根本原因不是命令写错，而是 Doctrine 连接配置或类型映射没对齐：
-
doctrine:mapping:import依赖当前doctrine.dbal配置能真实连上目标库，并读取INFORMATION_SCHEMA；如果database_url指向的是测试库而非实际业务库，就什么都导不出来 - 表名含大写字母（如
UserLog）或下划线（如user_login_log），Doctrine 默认按驼峰规则转成Userlog或UserLoginLog，导致找不到对应表 -
ENUM、SET、JSON等类型未在doctrine.dbal.mapping_types中声明映射，Doctrine 直接跳过该字段甚至整张表 - 使用了非默认 EntityManager（比如配了
show或report连接），但没加--em=xxx参数，命令默认走default
doctrine:mapping:convert 和 doctrine:mapping:import 到底用哪个？
二者目的相同，但行为差异关键：
-
doctrine:mapping:import --force AcmeBundle annotation：直接从数据库内省，生成注解格式的元数据文件（如AcmeBundle/Resources/config/doctrine/Article.orm.php），适合已有稳定表结构、想快速建模的场景 -
doctrine:mapping:convert --from-database yml ./config/doctrine：先导出为 YAML 元数据（Article.orm.yml），再手动调整字段类型、关系、是否 nullable 等，最后用doctrine:mapping:import或doctrine:mapping:convert annotation ./src转成 PHP 实体 —— 更可控，尤其适合字段命名不规范或需补全@ORM\JoinColumn的情况 - YAML 方式必须手动修正第一行类名，例如生成的
Article:要改成App\Entity\Article:，否则doctrine:generate:entities会报Invalid mapping file
生成实体后，getter/setter 和 Repository 怎么补全？
doctrine:generate:entities 已被弃用（Symfony 4.0+），现在统一用 make:entity，但它默认不生成 Repository 类，也不自动加返回类型：
- 要生成 Repository，得先在实体类里显式声明：
@ORM\Entity(repositoryClass="App\Repository\ArticleRepository")，再运行make:repository -
make:entity --regenerate会覆盖所有 getter/setter 方法体，包括你手写的逻辑（比如setPublishedAt()里同步updatedAt），它不做 diff，只全量重写 - 启用返回类型需满足两个条件：项目 PHP 版本 ≥ 8.0 且
symfony/maker-bundle≥ v1.40；否则即使属性写了private string $title;，生成的getTitle()仍是public function getTitle()，没有: string - 关联字段（如
ManyToMany）的add/remove方法不出现？检查inversedBy和mappedBy是否配对，且目标实体类已存在并被 Doctrine 扫描到
从数据库生成实体时最容易忽略的三件事
一是 mapping_types 配置必须写在正确的 connection 下（比如你用 --em=report，就得在 doctrine.dbal.connections.report.mapping_types 里加 enum: string）；二是 --filter=article 参数对表名大小写敏感，Article 和 article 可能匹配不到；三是生成的实体类默认没 __construct() 初始化集合属性，OneToMany 关系需要手动加 $this->comments = new ArrayCollection();，否则运行时报 Call to a member function add() on null。
