Doctrine 通过实体注解（如 @JoinColumn）声明关联并启用外键生成，需确保拥有方正确配置 name/referencedColumnName/onDelete，双方 mappedBy/inversedBy 一致，且数据库支持并未禁用外键约束。
Doctrine 中外键不是靠手动写 SQL 建立的，而是通过实体注解（或 YAML/XML 配置）声明关联关系后，由 Doctrine 自动推导并生成带外键约束的表结构。关键在于：**正确配置多对一（ManyToOne）、一对多（OneToMany）、一对一（OneToOne）等映射，并启用数据库级外键行为**。
用 @JoinColumn 显式定义外键字段
在 ManyToOne 或 OneToOne 的拥有方（owning side）实体中，必须使用 @JoinColumn 指定外键列名和引用目标主键。这是生成物理外键的前提。
-
name：当前表中存储外键值的字段名（如
user_id） -
referencedColumnName：被引用表的主键字段名（通常是
id） - nullable：是否允许为空（影响外键是否可为 NULL）
-
onDelete：指定数据库级级联动作，如
"CASCADE"、"SET NULL"
示例：
// src/Entity/Reservation.php/** * @ORM\ManyToOne(targetEntity="Panier", inversedBy="reservations") * @ORM\JoinColumn(name="panier_id", referencedColumnName="id", onDelete="CASCADE") */ private $panier;
确保双方映射逻辑一致
一对多 / 多对一关系必须成对配置，且 mappedBy 和 inversedBy 要指向对方实体中定义的属性名。
- 多对一端（如 Reservation → Panier）是拥有方，负责定义
@JoinColumn - 一对多端（如 Panier → Reservation）是被拥有方，只用
@OneToMany(mappedBy="panier")，不加 JoinColumn - 若两边都写 JoinColumn，或 mappedBy 名称拼错，会导致 schema 工具忽略外键生成
启用外键生成与验证
Doctrine 默认会为支持外键的数据库（MySQL、PostgreSQL）生成 FOREIGN KEY 约束，但需满足以下条件：
- 数据库驱动支持外键（SQLite 默认关闭，需显式开启 PRAGMA foreign_keys=ON）
- 未禁用外键生成：检查
doctrine.dbal.platform是否被覆盖，或是否设置了foreign_key_constraints: false（YAML 配置中） - 运行迁移或 schema 更新命令时无报错：
php bin/console doctrine:schema:update --force或php bin/console doctrine:migrations:migrate
若执行后仍无外键，可用 --dump-sql 查看 Doctrine 计划执行的语句，确认是否包含 ADD CONSTRAINT ... FOREIGN KEY。
处理遗留表或非主键关联
当关联字段不是主键（如用单据号 C_CDE_NUMERO 关联），Doctrine 默认拒绝建外键。此时不能用标准 ManyToMany，而应：
- 改用
@JoinTable显式定义中间表结构 - 在
joinColumns和inverseJoinColumns中分别指定业务字段名与referencedColumnName - 确保目标字段在数据库中有唯一索引（Doctrine 不强制，但数据库外键要求被引用列唯一或为主键）
这种场景下，外键约束可能无法直接创建，但程序级关联逻辑仍可正常工作。
