@EmbeddedId类使用@ManyToOne合规性及遗留表Hibernate映射方案咨询

1. 主键身份稳定性要求：实体主键需要满足不可变、可独立序列化、可精准等值判断的特性。如果主键类嵌入@ManyToOne关联，关联实体的主键一旦变更，将直接导致当前实体的主键身份失效；同时关联实体如果是Hibernate代理对象，在未初始化的场景下调用equals/hashCode会出现懒加载异常或等值判断错误。
2. 持久化逻辑混乱风险：主键是实体被持久化上下文识别的核心依据，若主键依赖其他关联实体，执行实体保存、查询等操作时，必须保证关联实体处于托管态，否则会出现瞬态实体异常、级联逻辑混乱等问题，JPA的EntityManager#find等标准接口也无法直接传入主键值查询，使用成本极高。
3. 可移植性缺失：你当前代码能正常运行是Hibernate对非规范用法做了厂商扩展，若更换其他JPA实现（如EclipseLink、OpenJPA）会直接抛出语法错误，不符合JPA规范的跨实现兼容要求。

推荐使用@EmbeddedId + @MapsId的标准写法，既完全匹配现有表结构，又符合JPA规范，代码调整如下：

1. 调整嵌入式主键类 #

移除关联注解，仅存储关联实体的主键值：

@Embeddable
@Data
@NoArgsConstructor
@AllArgsConstructor
public class AuthorizationHistorySssPropertyPK implements Serializable {
    @Column(name = "applicationSss", nullable = false)
    private int applicationSss;

    @Column(name = "dataTime", nullable = false)
    private Timestamp dataTime;
}

2. 调整主实体类 #

将关联关系移到主实体中，通过@MapsId绑定主键字段：

@Entity
@Table(name = "`AuthorizationHistory`")
@Data
@NoArgsConstructor
public class AuthorizationHistory {

    @EmbeddedId
    private AuthorizationHistorySssPropertyPK authorizationHistorySssPropertyPK;

    @ManyToOne
    @JoinColumn(name = "applicationSss", referencedColumnName = "sss", nullable = false, insertable = false, updatable = false)
    @MapsId("applicationSss")
    private Sss sss;

    @Column(name = "login", nullable = false)
    private String login;

    @Column(name = "password", nullable = false)
    private String password;

    @Column(name = "status", nullable = false)
    private byte status;

    public AuthorizationHistory(Sss sss, String login, String password, Timestamp timestamp, byte status) {
        this.authorizationHistorySssPropertyPK = new AuthorizationHistorySssPropertyPK(sss.getSss(), timestamp);
        this.sss = sss;
        this.login = login;
        this.password = password;
        this.status = status;
    }
}

方案说明 #

• 表结构完全无改动，applicationSss字段的映射逻辑和之前完全一致
• 主键仅存储基础类型值，equals/hashCode计算稳定，不会出现代理对象相关异常
• 完全符合JPA2.1+规范，支持所有标准JPA操作，跨实现可移植
• 关联操作的使用方式和之前完全一致，无需调整业务逻辑

可选：@IdClass实现方式 #

如果不想使用嵌入式主键，也可以用@IdClass实现，效果完全一致：

// 主键类
@Data
@NoArgsConstructor
@AllArgsConstructor
public class AuthorizationHistorySssPropertyPK implements Serializable {
    private int applicationSss;
    private Timestamp dataTime;
}

// 主实体
@Entity
@Table(name = "`AuthorizationHistory`")
@IdClass(AuthorizationHistorySssPropertyPK.class)
@Data
@NoArgsConstructor
public class AuthorizationHistory {
    @Id
    @Column(name = "applicationSss", nullable = false)
    private int applicationSss;
    
    @Id
    @Column(name = "dataTime", nullable = false)
    private Timestamp dataTime;

    @ManyToOne
    @JoinColumn(name = "applicationSss", referencedColumnName = "sss", nullable = false, insertable = false, updatable = false)
    private Sss sss;
    
    // 其他字段、构造方法保持逻辑一致即可
}

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