Hibernate映射复合外键与租户ID时遭遇字段映射冲突问题求助

我最近在为一组SQL表做Hibernate领域类映射时卡壳了，试了好几种写法都遇到了字段映射冲突的问题，实在没辙了来求助大家！

首先是我的SQL表结构：

CREATE TABLE org (
    id UUID PRIMARY KEY DEFAULT uuidv7(),
    name VARCHAR(50) NOT NULL
);
CREATE TABLE org_entity (
    id UUID PRIMARY KEY DEFAULT uuidv7(),
    name VARCHAR(50) NOT NULL,
    org_id UUID NOT NULL  REFERENCES org(id)
);
CREATE UNIQUE INDEX ui_org_entity ON org_entity (org_id, id);

CREATE TABLE entity_field (
    id UUID PRIMARY KEY DEFAULT uuidv7(),
    name VARCHAR(50) NOT NULL,
    org_id UUID NOT NULL,
    entity_id UUID NOT NULL,
    FOREIGN KEY (org_id, entity_id) REFERENCES org_entity(org_id, id)
);

我的需求是：所有实体都要保留org_id字段用于多租户过滤，同时在Java代码中维护entity_field表的复合外键关联。但我写的EntityField类一直报错，代码如下：

@Entity
@Table(name = "entity_field")
@Getter
@Setter
@NoArgsConstructor
@ToString(callSuper = true)
public class EntityField extends BaseOrg {

    @ManyToOne(optional = false, fetch = FetchType.LAZY)
    @JoinColumn(name = "org_id", nullable = false, referencedColumnName = "id")
    protected Org org;

    @TenantId               // <----------------- 这里是问题点之一
    @ToString.Exclude
    @Setter(AccessLevel.NONE)
    @Column(name = "org_id", insertable = false, updatable = false)
    protected UUID orgId;
    
    @ManyToOne(optional = false, fetch = FetchType.LAZY)
    @JoinColumns({ @JoinColumn(name = "org_id", referencedColumnName = "org_id", nullable = false), @JoinColumn(name = "entity_id",
        referencedColumnName = "id", nullable = false) })
    protected OrgEntity entity;

    @ToString.Exclude
    @Setter(AccessLevel.NONE)
    @Column(name = "entity_id", insertable = false, updatable = false)
    private UUID entityId;
    
    public void setOrg(final Org org) {

        if (org != null && this.org != null && !org.equals(this.org)) {
            throw new IllegalStateException("Org does not match current org");
        }
        this.org = org;
        orgId = org != null ? org.getId() : null;
    }
    
    public void setEntity(final OrgEntity entity) {

        if (entity != null && entity.getOrg() != null && org != null && !entity.getOrg().equals(org)) {
            throw new IllegalStateException("Entity org does not match current org");
        }
        this.entity = entity;
        entityId = entity != null ? entity.getId() : null;
    }   
}

我遇到的具体错误有三个：

1. 首先是字段重复映射的错误：

Column 'org_id' is duplicated in mapping for entity

2. 当我尝试修改insertable/updateable属性来解决重复映射时，又出现了关联映射的冲突：

Column mappings for property 'org' mix insertable with 'insertable=false'

3. 另外，Hibernate不允许我在类属性上标注@TenantId注解来实现多租户过滤。

我觉得这个场景应该不算罕见，就是想同时维护复合外键和租户ID字段，有没有大佬能指点一下正确的映射方式？

解决方案参考 #

1. 移除重复的org关联映射，利用复合外键关联同步org信息

你现在同时映射了org和entity两个关联，但entity本身已经包含了org的关联关系，而且entity_field的org_id是复合外键的一部分，完全可以通过entity.getOrg()获取org信息，不需要单独映射org字段，这样就能从根源上避免org_id重复映射的问题。

2. 调整租户ID(orgId)的映射与@TenantId的使用

把orgId设为只读属性，通过setEntity方法同步它的值，同时将@TenantId标注在这个只读字段上（如果你的多租户框架支持这种方式）。修改后的代码示例：

@Entity
@Table(name = "entity_field")
@Getter
@Setter
@NoArgsConstructor
@ToString(callSuper = true)
public class EntityField extends BaseOrg {

    @ManyToOne(optional = false, fetch = FetchType.LAZY)
    @JoinColumns({ 
        @JoinColumn(name = "org_id", referencedColumnName = "org_id", nullable = false, insertable = true, updatable = true), 
        @JoinColumn(name = "entity_id", referencedColumnName = "id", nullable = false, insertable = true, updatable = true) 
    })
    protected OrgEntity entity;

    @TenantId
    @ToString.Exclude
    @Setter(AccessLevel.NONE)
    @Column(name = "org_id", insertable = false, updatable = false)
    protected UUID orgId;
    
    @ToString.Exclude
    @Setter(AccessLevel.NONE)
    @Column(name = "entity_id", insertable = false, updatable = false)
    private UUID entityId;
    
    public void setEntity(final OrgEntity entity) {
        if (entity != null && this.entity != null && !entity.equals(this.entity)) {
            // 校验org一致性
            if (orgId != null && !entity.getOrg().getId().equals(orgId)) {
                throw new IllegalStateException("Entity org does not match current org");
            }
        }
        this.entity = entity;
        entityId = entity != null ? entity.getId() : null;
        orgId = entity != null ? entity.getOrg().getId() : null;
    }

    // 提供获取Org对象的便捷方法
    public Org getOrg() {
        return entity != null ? entity.getOrg() : null;
    }
}

3. 替代方案：使用Hibernate Filter实现多租户过滤

如果@TenantId注解的限制较多，可以改用Hibernate的Filter机制来实现基于org_id的多租户过滤，这样不需要依赖特定注解：

首先在实体类上定义过滤器：

@FilterDef(name = "tenantFilter", parameters = @ParamDef(name = "tenantId", type = "uuid"))
@Filter(name = "tenantFilter", condition = "org_id = :tenantId")
@Entity
@Table(name = "entity_field")
// 其他注解...
public class EntityField extends BaseOrg {
    // ... 类内容
}

然后在会话中启用过滤器（可以放在AOP拦截器或者会话初始化逻辑中）：

Session session = entityManager.unwrap(Session.class);
session.enableFilter("tenantFilter").setParameter("tenantId", currentTenantId);

这样同样能实现多租户数据过滤，同时避免注解冲突的问题。

备注：内容来源于stack exchange，提问作者Miguel Angel