@TenantId结合@JoinColumns使用时触发Hibernate未实现异常问题

问题场景 #

两个实体均包含标注@TenantId的tenantId字段，原本基于value字段建立单向一对多关联：

@OneToMany(fetch = FetchType.LAZY)
@JoinColumn(name = "value", referencedColumnName = "value")
private List<EntityB> entities;

为了仅关联同租户的实体，尝试使用@JoinColumns配置tenantId+value的复合关联：

@OneToMany(fetch = FetchType.LAZY)
@JoinColumns({
  @JoinColumn(name = "tenantId", referencedColumnName = "tenantId"),
  @JoinColumn(name = "value", referencedColumnName = "value")
})
private List<EntityB> entities;

此时抛出异常：

org.hibernate.cfg.NotYetImplementedException: Still need to wire in composite in-memory value generation

单独用@JoinColumn关联tenantId，或用@JoinColumns关联非@TenantId标注的多字段均正常，仅含@TenantId的复合关联触发异常。

原因分析 #

@TenantId通常是多租户框架（如Spring Data JPA多租户扩展）的标识注解，Hibernate对带有这类注解的字段有特殊的自动值生成/上下文注入逻辑。当把该字段加入复合关联键时，Hibernate内部的复合键值生成逻辑尚未适配这种租户字段的特殊处理，因此抛出未实现异常。

解决方案 #

方案1：使用@Where注解过滤租户（推荐） #

无需修改关联的JoinColumn结构，直接通过@Where注解强制过滤同租户的记录，多租户框架会自动注入当前上下文的租户ID：

@OneToMany(fetch = FetchType.LAZY)
@JoinColumn(name = "value", referencedColumnName = "value")
@Where(clause = "tenantId = :currentTenantId")
private List<EntityB> entities;

这种方式契合多租户设计逻辑，且避免了Hibernate的复合键处理限制。

方案2：自定义关联查询逻辑 #

通过@NamedQuery或自定义Repository方法实现关联查询，绕开注解的限制：

1. 在EntityA上定义命名查询：

@NamedQuery(
    name = "EntityA.getEntitiesB",
    query = "SELECT eb FROM EntityB eb WHERE eb.tenantId = :tenantId AND eb.value = :value"
)

2. 在业务代码中通过EntityManager调用查询：

List<EntityB> entities = entityManager.createNamedQuery("EntityA.getEntitiesB", EntityB.class)
    .setParameter("tenantId", currentTenantId)
    .setParameter("value", entityA.getValue())
    .getResultList();

方案3：禁用租户字段的自动生成 #

在@JoinColumn中指定insertable=false和updatable=false，告诉Hibernate不要自动处理该字段的值生成（需确保tenantId已由其他逻辑正确设置）：

@OneToMany(fetch = FetchType.LAZY)
@JoinColumns({
  @JoinColumn(name = "tenantId", referencedColumnName = "tenantId", insertable = false, updatable = false),
  @JoinColumn(name = "value", referencedColumnName = "value")
})
private List<EntityB> entities;

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