doctrine:database:create成功但数据插不进去，是因为该命令只创建数据库，不创建表结构；实体类需正确配置@orm\entity、@orm\column和@orm\id等注解，并通过doctrine:migrations:migrate或doctrine:schema:create生成表。
doctrine:database:create 能跑通，不代表你的实体能存进去——多数人卡在映射配置和迁移同步上，不是数据库连不上。
实体类写完后，为什么 php bin/console doctrine:database:create 成功但数据插不进去？
因为 Doctrine 默认只管建库，不管表结构。实体类（Entity）只是 PHP 类，没告诉 Doctrine “这张表长什么样”，它就完全不知道该建什么字段、加什么约束。
常见错误现象：php bin/console doctrine:schema:validate 报错说 “The mapping files are invalid”，或插入时抛出 ORMException 提示找不到字段。
- 确保实体类用了
@ORM\Entity和@ORM\Table注解（PHP 8+ 推荐用#[ORM\Entity]属性语法） - 每个字段必须有
@ORM\Column（如@ORM\Column(type="string", length=255)），不能只写public $name; - 主键必须显式标注
@ORM\Id+@ORM\GeneratedValue，哪怕你用的是自增整数 - 别漏掉
use Doctrine\ORM\Mapping as ORM;，否则注解根本不会被解析
php bin/console make:entity 生成的代码为啥有时不能直接用？
这个命令生成的是骨架代码，但默认不包含关联关系、索引、非空约束等业务必需项，且字段类型常偏保守（比如全用 string，实际可能需要 datetime_immutable 或 json）。
使用场景：适合快速启动原型，但上线前必须人工检查并补全。
-
make:entity不会自动加@ORM\UniqueConstraint，邮箱去重得自己写 - 日期字段默认是
datetime，但 Doctrine 8+ 推荐用datetime_immutable避免意外修改 - JSON 字段要显式写
@ORM\Column(type="json")，不能靠类型提示（array或stdClass不生效） - 如果实体里有构造函数，
make:entity不会帮你处理__construct()中对关联集合的初始化（比如$this->tags = new ArrayCollection()）
执行 php bin/console doctrine:migrations:migrate 前必须确认三件事
迁移不是“一键同步”，它是基于当前实体定义与数据库结构的差异生成 SQL。一旦跳过验证，轻则字段缺失，重则删表丢数据。
- 先跑
php bin/console doctrine:schema:validate --skip-sync看映射是否合法 - 再跑
php bin/console doctrine:migrations:diff—— 它会生成新迁移文件，但不会执行；检查生成的 SQL 是否符合预期（尤其是DROP COLUMN或CHANGE TYPE） - 确认
doctrine_migrations.yaml里organize_migrations: "year_and_month"是否开启，避免多个迁移挤在一个文件里导致回滚失败
关联字段加载慢？别急着写 DQL，先看 fetch="EAGER" 的副作用
fetch="EAGER" 看似省事，但会强制触发 JOIN 查询，哪怕你根本没用到关联数据。90% 的 N+1 问题其实源于懒加载没配好，而不是 EAGER 本身。
性能影响：一个 User 查 100 条记录，关联 Post，EAGER 会让 Doctrine 发 1 条带 JOIN 的大查询；LAZY 则默认发 101 条（1 次主查 + 100 次关联查），但可通过 join 或 select 显式优化。
- 多对一（
@ORM\ManyToOne）默认 LAZY，安全；一对一也建议 LAZY - 一对多（
@ORM\OneToMany）默认 LAZY，但集合未初始化时调用count()或foreach才触发查询 - 真要预加载，用
$qb->leftJoin('u.posts', 'p')->addSelect('p')，比全局 EAGER 可控得多 -
fetch="EXTRA_LAZY"对集合有用（支持count()不查全量），但仅限 Doctrine >= 2.6
#[ORM\OrderBy(["serialNumber" => "ASC"])] 却没生效？那大概率是因为你忘了中间表字段不在目标实体里——这种排序必须落在关联映射定义侧，而不是靠数据库表里的 serial_number 字段自动识别。
