JPA映射复合主键关联实体报错：无法修改外键约束列

1. 对齐复合主键映射的一致性 #

• 确认OrderHasWorkstep的复合主键类（如OrderHasWorkstepId）中，关联Workstep的字段必须和Workstep的复合主键字段完全匹配。比如Workstep用三个字段当主键，那OrderHasWorkstepId就得包含这三个字段，不能只放workstep_no。
• 复合主键类必须实现Serializable接口，并重写equals()和hashCode()方法——这是JPA的强制要求，避免主键匹配异常引发约束冲突。

2. 修正外键关联的注解配置 #

• 在OrderHasWorkstep实体中关联Workstep时，要用@ManyToOne配合@JoinColumns指定所有外键列，不能只关联单个列。示例代码：

@ManyToOne
@JoinColumns({
    @JoinColumn(name = "workstep_no", referencedColumnName = "workstep_no", insertable = false, updatable = false),
    @JoinColumn(name = "xxx_col", referencedColumnName = "xxx_col", insertable = false, updatable = false),
    @JoinColumn(name = "yyy_col", referencedColumnName = "yyy_col", insertable = false, updatable = false)
})
private Workstep workstep;

设置insertable = false, updatable = false是因为主键字段的赋值应由复合主键类处理，避免JPA尝试修改外键列触发约束。

3. 校验数据库外键约束的完整性 #

• 检查fk_order_has_workstep_workstep约束是否正确关联了Workstep表的所有主键列，而非仅workstep_no。如果数据库中外键只关联了单个列，必须修改约束，让它关联Workstep的全部主键列，和实体类映射保持一致。
• MySQL下修改外键的SQL示例：

-- 删除旧约束
ALTER TABLE order_has_workstep DROP FOREIGN KEY fk_order_has_workstep_workstep;
-- 创建关联全主键列的新约束
ALTER TABLE order_has_workstep
ADD CONSTRAINT fk_order_has_workstep_workstep
FOREIGN KEY (workstep_no, xxx_col, yyy_col)
REFERENCES workstep(workstep_no, xxx_col, yyy_col);

4. 排查主键生成策略错误 #

• 确保复合主键类中的字段没有错误配置自动生成策略（如@GeneratedValue），复合主键通常由手动赋值或关联实体传递，自动生成会导致JPA尝试修改主键列，触发外键约束报错。

5. 清理缓存并调整DDL生成策略 #

• 如果启用了JPA自动生成DDL（如spring.jpa.hibernate.ddl-auto=update），先改为none，手动调整数据库结构后再启动应用，避免Hibernate自动修改被外键约束的列。

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