JPA共享公共字段复合主键映射时schemaId传null问题咨询

问题背景 #

两张采用复合主键的表共用公共字段schemaId，表结构如下：

• 表A：复合主键为schemaId、aID
• 表B：复合主键为schemaId、bID，通过schemaId+aID外键关联表A
  其中schemaId为固定常量值，A和B为一对多关系：单条A记录可关联多条B记录。

问题复现 #

最初B实体的@ManyToOne配置如下：

@ManyToOne(cascade = CascadeType.ALL, fetch = FetchType.LAZY)
@JoinColumn(name = "aID", referencedColumnName = "aID")
@JoinColumn(name = "schemaId", referencedColumnName = "schemaId")
private A a;

该配置可正常插入数据，但无法在B实体中保留独立的schemaId字段，无法满足其他表复用B表复合主键的需求。
尝试给关联的@JoinColumn添加insertable = false, updatable = false配置来保留独立字段后，schemaId插入时被赋值为null，关联关系和字段赋值无法同时正常工作。
当前存在问题的实体代码如下（注意B的主键类存在笔误，类名误写为APK）：

// 实体A
@IdClass(APK.class)
@Entity
public class A
{
   @Id
   private Integer schemaId;
   @Id
   private Integer aId;
   @OneToMany(cascade = CascadeType.ALL, fetch = FetchType.LAZY, mappedBy = "a")
   private List<B> blist;
   // 其余属性、方法省略
}

// A的复合主键类
public class APK implements Serializable{
   private Integer schemaId;
   private Integer aId;
   // 需实现equals、hashCode，省略
}

// 实体B
@IdClass(BPK.class)
@Entity
public class B
{
   @Id
   private Integer schemaId;
   @Id
   private Integer bId;
   private Integer aId;

   @ManyToOne(cascade = CascadeType.ALL, fetch = FetchType.LAZY)
   @JoinColumn(name = "aID", referencedColumnName = "aID")
   @JoinColumn(name = "schemaId", referencedColumnName = "schemaId")
   private A a;
}

// B的复合主键类（原代码笔误写为APK）
public class BPK implements Serializable{
   private Integer schemaId;
   private Integer bId;
   // 需实现equals、hashCode，省略
}

正确配置方法 #

核心遵循JPA的基础规则：同一个数据库列只能有一个可写入的属性映射，其余映射到该列的属性必须设为只读，同时手动维护关联对象和本地字段的值同步即可。

修改步骤 #

1. 给B实体中@ManyToOne关联的两个@JoinColumn都加上insertable = false, updatable = false，把外键列的写入权限交还给B实体中独立映射的schemaId、aId字段，避免列重复映射冲突。
2. 在B实体中添加关联设置的便捷方法，每次设置关联A对象时，自动把A的主键值同步到B本地的schemaId、aId字段，从根源避免插入null的问题。

修正后B实体代码 #

@IdClass(BPK.class)
@Entity
public class B
{
   @Id
   private Integer schemaId;

   @Id
   private Integer bId;

   @Column(name = "aID")
   private Integer aId;

   @ManyToOne(cascade = CascadeType.ALL, fetch = FetchType.LAZY)
   @JoinColumn(name = "aID", referencedColumnName = "aID", insertable = false, updatable = false)
   @JoinColumn(name = "schemaId", referencedColumnName = "schemaId", insertable = false, updatable = false)
   private A a;

   // 统一通过该方法设置关联对象，自动同步字段值
   public void setA(A a) {
       this.a = a;
       if (a != null) {
           this.schemaId = a.getSchemaId();
           this.aId = a.getAId();
       }
   }

   // 其余getter/setter、业务方法省略
}

注意事项 #

• 所有IdClass主键类必须实现equals()和hashCode()方法，否则JPA的一级缓存、实体状态判断会出现异常。
• 不要直接给B的a字段反射赋值，统一走setA方法，避免漏同步schemaId和aId的值。
• 该配置逻辑同样适用于@EmbeddedId的复合主键场景，只需要把对应主键类里的字段映射规则调整一致即可。

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