Symfony+Doctrine外键关联复合唯一约束插入数据报错如何解决

问题原因 #

• 核心错误是复合外键的注解写法不符合Doctrine规范：多个JoinColumn定义的复合外键必须使用JoinColumns注解包裹，否则Doctrine只能识别最后一个JoinColumn配置，提取关联实体字段值时找不到slug对应的元数据，就会抛出数组索引不存在的错误。
• 次要可能原因：Currency实体的slug和type私有属性没有编写对应的public getter方法，Doctrine无法读取属性值填充外键。
• 额外说明：Doctrine默认优先支持关联指向目标实体的主键，关联非主键唯一约束时，部分旧版本Doctrine需要目标字段被标记为实体ID（复合主键）才能正常工作。

解决方法 #

方法1：修正关联注解写法（保留实体关联） #

把ExchangeRateHistoryType实体的关联注解改成如下写法，用JoinColumns包裹两个外键定义：

#[ORM\ManyToOne(targetEntity: Currency::class)]
#[ORM\JoinColumns([
    new ORM\JoinColumn(name: 'currency_slug', referencedColumnName: 'slug', nullable: false),
    new ORM\JoinColumn(name: 'currency_type', referencedColumnName: 'type', nullable: false)
])]
private ?Currency $currency;

修改完成后重新生成迁移并执行，确认Currency实体已经添加getSlug()和getType()公共方法即可。如果修改后仍然报错，建议升级Doctrine ORM到2.9及以上版本，旧版本对非主键复合关联的支持存在缺陷。

方法2：去掉实体关联，直接存字段（更符合反规范化需求） #

你的初衷是减少join查询，定义为实体关联的话Doctrine查询时仍然会自动关联Currency表，反而达不到反规范化的目的。可以直接把两个外键字段改为普通字段，手动维护值：

#[ORM\Column(type: 'string', length: 25, nullable: false)]
private ?string $currencySlug;

#[ORM\Column(type: 'smallint', length: 1, nullable: false)]
private ?int $currencyType;

// 自己编写set方法，传入Currency对象时自动赋值两个字段
public function setCurrency(Currency $currency): void
{
    $this->currencySlug = $currency->getSlug();
    $this->currencyType = $currency->getType();
}

这种写法完全不需要关联查询，性能更高，也不会出现关联映射的错误。

内容的提问来源于stack exchange，提问作者Fisher