SpringBoot 2.7.6+JPA多实体共享关联表的查询与插入问题

问题核心 #

你碰到的关键矛盾是：共享关联表的多态多对多场景下，@WhereJoinTable仅能解决查询过滤问题，但JPA默认不会自动填充区分关联类型的ENTITY_TYPE字段，导致插入时违反非空约束。

可行解决方案 #

1. 用@JoinColumnOrFormula自动填充类型字段（推荐） #

通过组合实体关联列和固定值公式列，让JPA在插入关联记录时自动写入ENTITY_TYPE的值：

@Entity
public class GreatEntity {
    // 基础字段...

    @ManyToMany
    @JoinTable(
        name = "REL_GREAT_ENTITY",
        joinColumns = @JoinColumn(name = "GREAT_ENTITY_ID"),
        inverseJoinColumns = @JoinColumnsOrFormulas({
            @JoinColumnOrFormula(column = @JoinColumn(name = "ENTITY_ID", referencedColumnName = "ID")),
            @JoinColumnOrFormula(formula = @JoinFormula(value = "1", referencedColumnName = "ENTITY_TYPE"))
        })
    )
    @WhereJoinTable(clause = "ENTITY_TYPE = 1")
    private Set<EntityA> entityAs = new HashSet<>();

    @ManyToMany
    @JoinTable(
        name = "REL_GREAT_ENTITY",
        joinColumns = @JoinColumn(name = "GREAT_ENTITY_ID"),
        inverseJoinColumns = @JoinColumnsOrFormulas({
            @JoinColumnOrFormula(column = @JoinColumn(name = "ENTITY_ID", referencedColumnName = "ID")),
            @JoinColumnOrFormula(formula = @JoinFormula(value = "2", referencedColumnName = "ENTITY_TYPE"))
        })
    )
    @WhereJoinTable(clause = "ENTITY_TYPE = 2")
    private Set<EntityB> entityBs = new HashSet<>();
}

这里@JoinFormula指定了固定的类型值，JPA在插入关联数据时会自动填充ENTITY_TYPE，同时@WhereJoinTable保证查询时只返回对应类型的关联数据。

2. 自定义关联实体+监听器手动控制 #

如果第一种方法不适用，可以将多对多拆分为一对多，手动管理关联表的字段填充：
首先定义关联表实体：

@Entity
@Table(name = "REL_GREAT_ENTITY")
public class GreatEntityRelation {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(name = "GREAT_ENTITY_ID")
    private Long greatEntityId;

    @Column(name = "ENTITY_ID")
    private Long entityId;

    @Column(name = "ENTITY_TYPE", nullable = false)
    private Integer entityType;

    // getter、setter省略
}

修改GreatEntity，替换多对多为一对多，并添加类型填充逻辑：

@Entity
@EntityListeners(GreatEntityListener.class)
public class GreatEntity {
    // 基础字段...

    @OneToMany(mappedBy = "greatEntityId", cascade = CascadeType.ALL, orphanRemoval = true)
    @Where(clause = "ENTITY_TYPE = 1")
    private Set<GreatEntityRelation> entityARelations = new HashSet<>();

    @OneToMany(mappedBy = "greatEntityId", cascade = CascadeType.ALL, orphanRemoval = true)
    @Where(clause = "ENTITY_TYPE = 2")
    private Set<GreatEntityRelation> entityBRelations = new HashSet<>();

    // 添加EntityA时自动设置类型
    public void addEntityA(EntityA entityA) {
        GreatEntityRelation relation = new GreatEntityRelation();
        relation.setGreatEntityId(this.getId());
        relation.setEntityId(entityA.getId());
        relation.setEntityType(1);
        entityARelations.add(relation);
    }

    // 同理实现addEntityB方法
}

配合监听器兜底检查字段：

public class GreatEntityListener {
    @PrePersist
    public void prePersist(GreatEntity greatEntity) {
        greatEntity.getEntityARelations().forEach(rel -> {
            if (rel.getEntityType() == null) rel.setEntityType(1);
        });
        greatEntity.getEntityBRelations().forEach(rel -> {
            if (rel.getEntityType() == null) rel.setEntityType(2);
        });
    }
}

这种方式更灵活，但需要手动管理关联关系，适合复杂业务场景。

问题根源解析 #

• @Where注解作用于实体自身的表，而非关联表，所以会尝试在GreatEntity的表中查找ENTITY_TYPE字段，触发ORA-00904错误。
• @WhereJoinTable仅在查询阶段生效，JPA的默认多对多逻辑只会处理关联ID字段，不会自动填充额外的区分字段，导致插入时ENTITY_TYPE为空，违反非空约束。

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