Hibernate ORM中同一列同时用于必填与可选复合外键的实现问题

方案1：JPA标准实现（无供应商依赖） #

你可以把可写属性和只读关联拆分开，规避JoinColumns属性必须一致的限制：

1. 所有分片IDShardID的写入、更新逻辑完全交给主键PersonId维护
2. 单独定义可空的teamId普通字段，负责Team关联的写入更新
3. 将Person到Team的关联设置为只读推导关联，完全由已有字段值映射生成

示例代码：

@EmbeddedId
protected PersonId id; // 内置shardId、personId两个字段，全权维护shard_id列

// 单独维护团队ID字段，支持空值、插入和更新
@Column(name = "team_id", nullable = true)
private Long teamId;

// 只读的Team关联，所有JoinColumn均标记为不可写，不会触发重复列报错
@ManyToOne(optional = true)
@JoinColumns({
    @JoinColumn(name = "shard_id", referencedColumnName = "shard_id", insertable = false, updatable = false),
    @JoinColumn(name = "team_id", referencedColumnName = "id", insertable = false, updatable = false)
})
private Team team;

// Shard关联同理，直接用主键的shardId推导即可
@ManyToOne(optional = false)
@JoinColumn(name = "shard_id", insertable = false, updatable = false)
private Shard shard;

操作逻辑：需要给Person分配/变更Team时，直接修改teamId字段值即可，只需在业务层校验目标Team的ShardID和当前Person的ShardID一致即可，关联对象team会在下次查询时自动同步。

方案2：Hibernate专有实现（支持直接操作关联对象） #

如果可以接受依赖Hibernate私有特性，可以用@JoinColumnOrFormula注解，把shard_id字段用公式引用，避开重复列校验，同时保留关联对象的直接写入能力：

@EmbeddedId
protected PersonId id;

@ManyToOne(optional = true)
@JoinColumnsOrFormulas({
    @JoinColumnOrFormula(formula = @JoinFormula(value = "shard_id", referencedColumnName = "shard_id")),
    @JoinColumnOrFormula(column = @JoinColumn(name = "team_id", referencedColumnName = "id", nullable = true))
})
private Team team;

该方案下你可以直接操作team属性赋值，比如person.setTeam(targetTeam)，Hibernate会自动从主键中取shard_id和你赋值的Team的ID做关联映射，不需要单独维护teamId字段。

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