Spring Boot 2.5.6中ManyToMany关联无法获取全部映射数据求助

1. 检查ManyToMany映射配置的正确性 #

• 确认Profil和Fonctionnalite的@ManyToMany注解配置完全匹配：
  • 在拥有方（比如Profil）的注解中，@JoinTable的name必须指向t_profils_fonctionnalites，joinColumns对应profil_id，inverseJoinColumns对应fonctionnalite_id，示例：

    @ManyToMany(fetch = FetchType.LAZY)
    @JoinTable(
        name = "t_profils_fonctionnalites",
        joinColumns = @JoinColumn(name = "profil_id"),
        inverseJoinColumns = @JoinColumn(name = "fonctionnalite_id")
    )
    private Set<Fonctionnalite> fonctionnalites;
    

  • 在关联的另一方（Fonctionnalite），必须使用mappedBy指向拥有方的关联属性，避免重复映射中间表：

    @ManyToMany(mappedBy = "fonctionnalites")
    private Set<Profil> profils;
    

  • 两边集合建议用Set而非List，符合ManyToMany无重复关联的语义，也能避免Hibernate处理重复元素时的异常。

2. 验证数据库中间表数据的有效性 #

• 直接查询数据库中间表，确认profil_id=1的记录是否存在且正确：

  SELECT * FROM t_profils_fonctionnalites WHERE profil_id = 1;
  

  • 检查返回的fonctionnalite_id是否在fonctionnalite表中有对应记录（确认外键约束生效，无脏数据）。
  • 对比profil_id=1和profil_id=2的记录格式，确保没有拼写错误（比如profil_id误写为profile_id）。

3. LAZY加载异常的排查 #

• 事务上下文问题：懒加载需要在Hibernate Session（即Spring事务）范围内初始化集合。如果Controller直接返回查询到的Profil，而Service层查询方法未开启事务，序列化返回结果时Session已关闭，无法初始化懒加载集合。
  • 解决：在Service层查询方法上添加@Transactional注解，确保在事务内完成集合初始化；或者使用Fetch Join主动加载关联集合：

    @Query("SELECT p FROM Profil p JOIN FETCH p.fonctionnalites WHERE p.id = :id")
    Profil findByIdWithFonctionnalites(@Param("id") Long id);
    

• 二级缓存干扰：如果开启了二级缓存，profil1的关联集合可能被缓存为空。可以重启应用清空缓存后重新测试。

4. EAGER加载部分数据缺失的排查 #

• 重复行导致的实体去重问题：Hibernate EAGER加载ManyToMany时会用左外连接查询，产生重复的Profil行。若查询未加DISTINCT，Hibernate可能错误截断集合或返回重复实体。
  • 解决：在JPQL查询中添加DISTINCT，或在Spring Data JPA查询方法上添加查询提示：

    @Query("SELECT DISTINCT p FROM Profil p JOIN p.fonctionnalites")
    List<Profil> findAllWithFonctionnalites();
    

• 实体equals/hashCode实现错误：如果Fonctionnalite的equals和hashCode依赖未初始化的懒加载属性，或未仅基于id判断，Hibernate组装集合时会错误丢弃部分数据。
  • 正确实现示例：

    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Fonctionnalite that = (Fonctionnalite) o;
        return Objects.equals(id, that.id);
    }
    
    @Override
    public int hashCode() {
        return Objects.hash(id);
    }
    

• Hibernate版本bug：Spring Boot 2.5.6对应Hibernate 5.4.32.Final，该版本在部分场景（如关联实体用@Inheritance）下会出现EAGER加载集合不完整的问题。可升级Hibernate到同分支最新版（如5.4.33.Final），无需升级Spring Boot核心：

  <dependency>
      <groupId>org.hibernate</groupId>
      <artifactId>hibernate-core</artifactId>
      <version>5.4.33.Final</version>
  </dependency>
  

5. 日志排查 #

• 开启Hibernate SQL日志，查看实际执行的SQL语句，确认关联查询是否正确：
  在application.yml中添加：

  logging:
    level:
      org.hibernate.SQL: DEBUG
      org.hibernate.type.descriptor.sql.BasicBinder: TRACE
  

  • 对比profil_id=1和profil_id=2的查询语句，检查是否存在差异或遗漏的关联查询。

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