Spring Boot JPA中如何将@TenantId作为复合主键的一部分？

针对你遇到的@TenantId无法标注在复合主键字段上的问题，这里提供几个可行的解决思路：

方案1：实体类单独新增租户ID字段，与复合主键字段映射同一列 #

把@TenantId标注在实体类的单独字段上，而非复合主键内部，同时让这个字段和复合主键里的academyId映射到数据库的同一列，避免数据冲突：

@Embeddable
public class AcademyUserKey implements Serializable {
    private Long academyId;
    private Long userId;
    
    // 实现equals、hashCode，以及getter/setter方法
}

@Entity
@Table(name = "academy_user")
public class AcademyUser {
    @EmbeddedId
    private AcademyUserKey key;

    @TenantId
    @Column(name = "academy_id", insertable = false, updatable = false)
    private Long academyId;

    // 其他业务字段与方法
}

设置insertable=false和updatable=false是为了让Hibernate只通过复合主键来维护该列的写入，避免字段冲突，同时@TenantId标注的字段会被Hibernate用于多租户的筛选逻辑。

方案2：通过生命周期方法手动注入租户ID到复合主键 #

利用JPA的生命周期注解，在实体持久化前将当前租户ID设置到复合主键的academyId字段中：

@Embeddable
public class AcademyUserKey implements Serializable {
    private Long academyId;
    private Long userId;
    
    // 实现equals、hashCode，以及getter/setter方法
}

@Entity
@Table(name = "academy_user")
public class AcademyUser {
    @EmbeddedId
    private AcademyUserKey key;

    @CurrentTenantIdentifier
    private String currentTenantId;

    @PrePersist
    public void injectTenantIdToKey() {
        // 转换类型适配你的租户ID格式
        key.setAcademyId(Long.parseLong(currentTenantId));
    }

    // 其他业务字段与方法
}

@CurrentTenantIdentifier会自动注入当前请求的租户ID，通过@PrePersist在实体保存前将其赋值给复合主键的对应字段，既满足多租户隔离，又保留复合主键的结构。

方案3：改用单主键+联合唯一约束替代复合主键 #

如果业务上允许，放弃复合主键，改用单主键加联合唯一约束来保证academy_id和user_id的唯一性，这样可以直接在租户ID字段上标注@TenantId：

@Entity
@Table(name = "academy_user", uniqueConstraints = {
        @UniqueConstraint(columnNames = {"academy_id", "user_id"})
})
public class AcademyUser {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @TenantId
    @Column(name = "academy_id")
    private Long academyId;

    @Column(name = "user_id")
    private Long userId;

    // 其他业务字段与方法
}

这种方案实现最简单，完全规避了复合主键与@TenantId的兼容性问题，同时联合唯一约束可以保证业务上的唯一性要求。

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