Spring Boot 3.1.2中Hibernate多对多关联实体无法加载问题

核心原因 #

1. 懒加载机制限制：Product的discounts集合使用FetchType.LAZY，默认仅在会话（EntityManager）开启时访问才会加载数据。调用productRepository.findAll(pageable)后，会话通常已关闭（Spring Data JPA默认方法执行完毕即关闭会话），此时访问集合无法触发加载，导致返回空。
2. 非维护端关联未主动加载：Product是多对多关联的非维护端（通过mappedBy="products"指定维护端为Discount），Hibernate不会自动加载非维护端的关联集合，需显式指定关联加载策略。
3. 潜在的实体类注解问题：@EqualsAndHashCode默认包含所有字段（包括关联集合），可能导致懒加载代理对象出现异常，间接影响集合加载。

解决方案 #

1. 使用EntityGraph显式加载关联集合（推荐） #

在ProductRepository中添加带有@EntityGraph的查询方法，指定加载discounts集合：

@Repository
public interface ProductRepository extends JpaRepository<Product, Integer> {
    @EntityGraph(attributePaths = "discounts")
    Page<Product> findAll(Pageable pageable);
}

该方式会在查询Product时主动执行关联查询，一次性加载关联的Discount数据，避免懒加载限制。

2. 使用JPQL Fetch Join查询 #

通过自定义JPQL语句实现关联加载，同时处理分页可能产生的重复结果：

@Repository
public interface ProductRepository extends JpaRepository<Product, Integer> {
    @Query("SELECT DISTINCT p FROM Product p LEFT JOIN FETCH p.discounts")
    Page<Product> findAllWithDiscounts(Pageable pageable);
}

LEFT JOIN FETCH会直接关联查询Discount数据，DISTINCT用于避免因多对多关联产生的重复Product记录。

3. 调整FetchType为EAGER（不推荐） #

若业务场景中每次查询Product都需要加载Discount，可将Product中的关联注解改为：

@ManyToMany(fetch = FetchType.EAGER, mappedBy = "products")
private Set<Discount> discounts = new HashSet<>();

注意：EAGER加载会导致每次查询Product都强制加载关联集合，可能引发性能问题，仅适合小型数据集场景。

4. 修复实体类的EqualsAndHashCode注解 #

排除关联集合，避免懒加载代理对象干扰：

@Entity
@Table(name = "products")
@Getter
@Setter
@Builder
@AllArgsConstructor
@NoArgsConstructor
@EqualsAndHashCode(exclude = "discounts") // 排除关联集合
public class Product {
    // ... 其他字段
    @ManyToMany(fetch = FetchType.LAZY, mappedBy = "products")
    private Set<Discount> discounts = new HashSet<>();
}

@Entity
@Table(name = "discounts")
@EqualsAndHashCode(exclude = "products") // 排除关联集合
public class Discount {
    // ... 其他字段
    @ManyToMany(cascade = {CascadeType.ALL})
    @JoinTable(
            name = "discounts_products",
            joinColumns = { @JoinColumn(name = "discount_id") },
            inverseJoinColumns = { @JoinColumn(name = "product_id") }
    )
    private Set<Product> products = new HashSet<>();
}

5. 验证数据库关联数据的正确性 #

你的验证SQL存在错误，正确的关联查询应使用中间表的外键关联Discount：

select * from products p 
left join discounts_products dp on p.product_id = dp.product_id 
left join discounts d on d.discount_id = dp.discount_id;

确保数据库中discounts_products表的discount_id和product_id字段值与discounts、products表的主键完全匹配。

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