升级至Spring Boot 3(Hibernate 6)时@JoinColumn顺序异常问题求解

问题根源 #

Hibernate 6对复合主键关联的@JoinColumns顺序要求严格匹配目标实体的主键属性定义顺序；在未显式定义复合主键类时，Hibernate依赖Java反射获取主键属性的顺序，而反射获取属性的顺序在不同环境或重启后可能不稳定，导致关联配置失效。

解决方案 #

方案1：严格匹配目标实体主键属性的定义顺序调整@JoinColumns #

目标实体EntityTwo的主键属性定义顺序是：typeName（对应数据库列type_name）→ actionName（对应数据库列action_name），因此EntityOne中的@JoinColumns必须按照这个顺序排列：

修改后的EntityOne代码：

@Entity
public class EntityOne{

  private String action;
  private String type;

  @ManyToOne(fetch = FetchType.LAZY, cascade = CascadeType.PERSIST)
  @NotFound(action = NotFoundAction.IGNORE)
  @JoinColumns({
      // 先匹配EntityTwo的第一个主键属性typeName（对应type_name）
      @JoinColumn(name = "type", referencedColumnName = "type_name", updatable = false, insertable = false),
      // 再匹配第二个主键属性actionName（对应action_name）
      @JoinColumn(name = "action", referencedColumnName = "action_name", updatable = false, insertable = false)
  })
  private EntityTwo entitytwo; // 修正类名拼写错误，原代码为Entitytwo
}

方案2：使用@IdClass显式定义复合主键类（推荐，彻底解决顺序不确定性） #

通过@IdClass定义复合主键类，明确主键的顺序，彻底避免反射带来的不确定性：

1. 定义复合主键类（必须实现Serializable，并重写equals和hashCode）：

import java.io.Serializable;
import java.util.Objects;

public class EntityTwoId implements Serializable {
    private String typeName;
    private String actionName;

    // 默认构造函数（必须）
    public EntityTwoId() {}

    // 带参构造函数（可选，方便使用）
    public EntityTwoId(String typeName, String actionName) {
        this.typeName = typeName;
        this.actionName = actionName;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        EntityTwoId that = (EntityTwoId) o;
        return Objects.equals(typeName, that.typeName) && Objects.equals(actionName, that.actionName);
    }

    @Override
    public int hashCode() {
        return Objects.hash(typeName, actionName);
    }
}

2. 修改EntityTwo，使用@IdClass绑定主键类：

@Entity
@IdClass(EntityTwoId.class)
public class EntityTwo {

    @Id
    @Column(name = "type_name")
    private String typeName;

    @Id
    @Column(name = "action_name")
    private String actionName;

    // 其他业务属性和方法
}

3. 保持EntityOne的@JoinColumns顺序与EntityTwoId中属性的定义顺序一致即可，此时Hibernate会严格按照主键类的属性顺序处理关联，不会出现顺序不稳定的问题。

说明 #

• 方案1仅适用于反射获取属性顺序稳定的场景，但无法从根本上避免环境差异导致的顺序变化；
• 方案2通过显式定义主键顺序，彻底消除了反射带来的不确定性，是Hibernate官方推荐的复合主键配置方式，稳定性更高。

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