Spring中多对多关联导致查询结果异常问题排查

问题1：懒加载Child时忽略status过滤条件 #

JPA默认的懒加载查询仅基于关联关系（parent的id）加载所有关联的Child，不会自动带上自定义的status过滤条件。除了你已经尝试的FETCH JOIN预加载，还有两种更可靠的解决方式：

方案1：使用@Filter全局过滤关联实体 #

给Child实体和Parent的关联字段添加过滤器，让懒加载时自动应用status条件：

@Entity
@Table(name = "CHI_CHILD")
@FilterDef(name = "activeChild", parameters = [ParamDef(name = "status", type = String::class)])
@Filter(name = "activeChild", condition = "STATUS = :status")
class Child(
    // 原有字段...
) {
    @ManyToMany(mappedBy = "children")
    val parents = mutableSetOf<Parent>()
}

// 在Parent的children字段上启用该过滤器
@Entity
@Table(name = "PAR_PARENT")
class Parent(
    // 原有字段...
) {
    @ManyToMany(cascade = [CascadeType.PERSIST, CascadeType.MERGE])
    @JoinTable(
        name = "PAR_CHI",
        joinColumns = [JoinColumn(name = "FK_PAR_ID")],
        inverseJoinColumns = [JoinColumn(name = "FK_CHI_ID")]
    )
    @Filter(name = "activeChild", condition = "STATUS = :status")
    val children = mutableSetOf<Child>()
}

使用时需要在EntityManager中启用过滤器：

entityManager.enableFilter("activeChild").setParameter("status", Status.ACTIVE.name)

方案2：自定义懒加载查询 #

直接在@ManyToMany注解中指定带过滤条件的查询语句，替代默认的懒加载查询：

@ManyToMany(cascade = [CascadeType.PERSIST, CascadeType.MERGE])
@JoinTable(...)
@Query("select c from Child c join c.parents p where p.id = ?1 and c.status = ?2")
val children = mutableSetOf<Child>()

问题2：H2数据库中FETCH JOIN未过滤Child的status #

这个问题是H2与PostgreSQL对JPA FETCH JOIN的解析逻辑差异导致的，可通过以下方式修复：

方案1：调整查询写法，用子查询明确过滤Child #

修改Repository的查询语句，通过子查询限定符合条件的Child：

@Repository
interface ParentRepository : JpaRepository<Parent, UUID> {
    @Query("select p from Parent p JOIN FETCH p.children cs where p.id=:id AND p.status=:status AND cs in (select c from Child c where c.status=:status)")
    fun findByIdAndStatus(id: UUID, status: Status): Optional<Parent>
}

方案2：开启H2的PostgreSQL兼容模式 #

在H2的连接URL中添加兼容模式配置，让H2对齐PostgreSQL的SQL解析规则：

spring.datasource.url=jdbc:h2:mem:testdb;MODE=PostgreSQL;DATABASE_TO_LOWER=TRUE;DEFAULT_NULL_ORDERING=HIGH

方案3：添加DISTINCT并改用LEFT JOIN FETCH #

多对多关联的FETCH JOIN可能返回重复的Parent实例，添加DISTINCT不仅能去重，还能让H2正确应用过滤条件：

@Repository
interface ParentRepository : JpaRepository<Parent, UUID> {
    @Query("select distinct p from Parent p LEFT JOIN FETCH p.children cs where p.id=:id AND p.status=:status AND cs.status=:status")
    fun findByIdAndStatus(id: UUID, status: Status): Optional<Parent>
}

额外检查：验证枚举类型映射 #

确认H2中CHI_CHILD表的STATUS字段类型为VARCHAR（和PostgreSQL一致），避免枚举类型的字符串值无法匹配。

注：你的Parent实体类名写为Branche，但Child中关联的是Parent，这应该是笔误，以上示例统一按Parent实体类名处理。

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