Spring JPA复合ID实体持久化时生成异常SQL的问题排查

解决方案 #

这个问题是双向关联配置缺失+复合主键的外键映射错误导致的，具体修复步骤如下：

1. 给StoreFileMetadata添加双向关联的@ManyToOne注解 #

@OneToMany的孤儿移除机制需要明确子实体与父实体的关联关系，否则Hibernate会错误地尝试将子实体的外键置空（也就是你看到的set file_id=null），而非正确处理关联逻辑。

在StoreFileMetadata中添加代码：

@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "file_id", insertable = false, updatable = false) // file_id是复合主键的一部分，禁止插入/更新
private StoreFile storeFile;

2. 修正StoreFile中@OneToMany的mappedBy属性 #

必须指定mappedBy指向子实体中对应的关联字段，同时确保orphanRemoval和cascade配置正确：

@OneToMany(mappedBy = "storeFile", cascade = CascadeType.ALL, orphanRemoval = true)
private List<StoreFileMetadata> metadataList = new ArrayList<>();

3. 确保复合主键类StoreFileMetadataId符合要求 #

复合主键类必须满足：

• 实现Serializable接口
• 重写equals()和hashCode()方法
• 字段名称、类型与StoreFileMetadata中的ID字段完全一致

示例代码：

public class StoreFileMetadataId implements Serializable {
    private Long fileId;
    private String key;

    // 无参构造、全参构造方法
    // 重写equals()和hashCode()方法
}

核心原因说明 #

Hibernate处理复合主键的关联时，必须明确双向映射关系。如果只配置@OneToMany而没有对应的@ManyToOne，Hibernate无法识别子实体的外键属于复合主键的一部分，就会生成错误SQL——既会重复拼接file_id条件，又会尝试将主键字段置空（这违反了主键非空的约束）。

用@EmbeddedId出现相同错误，也是因为同样的双向关联缺失问题，和主键类型无关。

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