Doctrine关联配置是数据模型正确性的基础，关键在于明确拥有方与反向方、确保字段真实存在且数据库约束匹配，多对多必须显式配置@JoinTable，集合属性须初始化为ArrayCollection。
Doctrine 关联配置不是“选填项”，而是数据模型正确性的基础。设错会导致查询失败、数据不一致、甚至迁移报错。关键不在写多少注解，而在理解 谁拥有关系、字段是否真实存在、数据库约束是否匹配 这三点。
明确 owning side 和 inverse side
Doctrine 要求每个多对一（ManyToOne）、一对多（OneToMany）、多对多（ManyToMany）关系必须指定拥有方（owning side）。只有 owning side 的映射会生成数据库外键或中间表字段。
- ManyToOne 必须是 owning side —— 外键总在“多”的那一侧
- OneToMany 默认是 inverse side —— 它只是“读取”关系，不控制数据库结构
- ManyToMany 中，必须且只能有一方标注 @JoinTable，这一方就是 owning side
- inverseBy 属性必须指向对方实体中定义的属性名，且类型声明要一致（如 string 或 ArrayCollection）
字段名和引用名必须真实存在
Doctrine 不会自动猜字段。@JoinColumn(name="xxx", referencedColumnName="yyy") 中的两个名字，必须分别对应当前表的列名、目标表的列名 —— 且 referencedColumnName 不必是主键，但必须有唯一性约束（如 UNIQUE 索引），否则关联可能返回多条或不准确结果。
- 错误示例：
referencedColumnName="code"，但 enteteCommande.code 没有建 UNIQUE 索引 → 查询可能出错 - 正确做法：先确认数据库中该字段有唯一约束，再在实体中写明
referencedColumnName="C_CDE_NUMERO" - 若用的是复合业务码（如 "ORD-2024-001"），确保它在目标表里真正能唯一标识一条记录
多对多不能跳过中间逻辑
Doctrine 的 ManyToMany 表面抽象，底层仍依赖中间表。即使你不显式建表，也要用 @JoinTable 告诉它怎么连。
- 禁止直接写
@ORM\ManyToMany(targetEntity="Tag")就完事 —— 缺少 joinColumns 时，Doctrine 默认找 id，必然报错 - 必须显式配置：
@JoinTable(name="article_tags", joinColumns={@JoinColumn(name="article_id")}, inverseJoinColumns={@JoinColumn(name="tag_id")}) - 如果中间表已存在且字段名不标准（比如叫
art_id和tag_code），就按实际列名写，不要迁就默认
关联集合初始化别遗漏
OneToMany 和 ManyToMany 的 Collection 属性必须初始化，否则运行时调用 add() 或 count() 会报错。
- 在构造方法里写：
$this->tags = new ArrayCollection(); - 不要用
array或null替代 —— Doctrine 需要 ArrayCollection 或 PersistentCollection 才能追踪变更 - PHP 8.1+ 可配合类型声明：
private Collection& $tags;，但初始化仍不可少
