Hibernate中@TenantId与@IdClass组合使用启动报错问题

问题原因 #

Hibernate 6.1.7.Final版本尚未实现带有@TenantId注解的@IdClass复合主键的内存值生成逻辑，这是框架的未完成特性，因此启动时抛出org.hibernate.cfg.NotYetImplementedException并提示"Still need to wire in composite in-memory value generation"。

可行解决方案 #

1. 手动赋值租户ID #

在保存实体前，手动为复合主键中的租户ID字段设置值，绕开Hibernate的自动生成逻辑：

实体类示例：

@Entity
@IdClass(NodeId.class)
public class Node {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Id
    @TenantId
    private String tenantId;
    
    // 其他业务字段、getter和setter
}

保存实体时手动赋值：

Node node = new Node();
node.setTenantId("指定的租户ID"); // 手动设置租户ID
nodeRepository.save(node);

2. 降级Hibernate版本 #

如果业务允许，可尝试降级到Hibernate 6.0.x系列版本，该版本未存在此未实现限制，但需注意版本与Spring Boot等依赖的兼容性。

3. 改用@EmbeddedId并调整主键生成策略 #

放弃@IdClass，改用@EmbeddedId实现复合主键，同时对非租户ID的主键字段调整生成方式（如手动赋值、使用表生成器），租户ID同样手动设置：

嵌入式主键类：

public class NodeId implements Serializable {
    private Long id;
    private String tenantId;
    
    // 构造方法、equals和hashCode实现、getter和setter
}

实体类示例：

@Entity
public class Node {
    @EmbeddedId
    private NodeId nodeId;
    
    // 其他业务字段、getter和setter
}

保存时赋值：

NodeId nodeId = new NodeId();
nodeId.setId(手动生成的ID); // 或使用表生成器生成
nodeId.setTenantId("指定的租户ID");

Node node = new Node();
node.setNodeId(nodeId);
nodeRepository.save(node);

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