使用@IdClass关联@Entity作为@Id时出现非空字段异常排查

核心问题点 #

1. Location实体缺少主键注解：Location类的id字段仅标注了@NotNull，没有@Id注解，JPA无法识别它是已持久化的实体，保存A时会将关联的Location视为新实体，触发非空字段校验。
2. 复合主键与实体字段映射不匹配：A类的@Id字段是Location location，但复合主键类AId中对应的是Long locationId，JPA无法建立两者的映射关系，导致无法正确识别关联的Location已存在于数据库，进而误判其name字段为null。

分步解决方案 #

1. 修复Location实体的主键定义 #

给id字段添加@Id注解，让JPA识别它的主键，确认其持久化状态：

@Entity
class Location {
   @Id // 标记为主键
   @NotNull
   private Long id;

   @NotNull
   @Column(nullable = false)
   private String name;
}

2. 修复复合主键与A类的映射关系 #

有两种可行方案：

方案一：用关联实体的主键字段作为A的复合主键

保持AId类不变，修改A类，将locationId作为@Id字段，同时维护与Location的关联关系：

@Entity
@IdClass(AId.class)
class A {
   @Id
   private String userName;

   @Id
   private Long locationId; // 对应AId中的locationId字段

   @ManyToOne(fetch = FetchType.LAZY)
   @JoinColumn(name = "location_id", referencedColumnName = "id", nullable = false, insertable = false, updatable = false)
   private Location location; // 关联关系设为不可插入/更新，避免与主键字段冲突

   private String userInformation;
}

方案二：调整复合主键类，使用关联实体类型

修改AId类，用Location类型作为主键的一部分（需保证AId和Location正确实现equals、hashCode）：

import java.util.Objects;

class AId implements Serializable {
  private Location location; // 对应A类中的location字段
  private String userName;

  // 必须重写equals和hashCode，满足Serializable和主键比较要求
  @Override
  public boolean equals(Object o) {
      if (this == o) return true;
      if (o == null || getClass() != o.getClass()) return false;
      AId aId = (AId) o;
      return Objects.equals(location, aId.location) && Objects.equals(userName, aId.userName);
  }

  @Override
  public int hashCode() {
      return Objects.hash(location, userName);
  }
}

同时修改A类的关联字段：

@Entity
@IdClass(AId.class)
class A {
   @Id
   private String userName;

   @Id
   @ManyToOne(fetch = FetchType.LAZY)
   @JoinColumn(name = "location_id", referencedColumnName = "id", nullable = false)
   private Location location;

   private String userInformation;
}

补充说明 #

当JPA无法识别关联实体的持久化状态时，会默认对关联实体的所有非空约束进行校验，哪怕该实体已存在于数据库。修复主键注解和复合主键映射后，JPA能正确关联已持久化的Location，不会再触发不必要的非空校验。

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