Spring JPA+Hibernate懒加载异常：N+1查询且关联集合为空

你遇到的两个核心问题：一是调用懒加载集合时触发大量无关查询，二是最终返回空集合。根源主要在Lombok循环引用、事务上下文缺失、双向关联维护不当这几个点，具体解决如下：

1. 修复Lombok引发的循环查询问题 #

你的实体用了@Data注解，它会自动生成包含所有字段的toString()、equals()和hashCode()方法。当你访问懒加载集合时，这些方法会被隐式调用（比如日志打印、调试查看对象），触发所有关联实体的懒加载，甚至因为双向关联（Explotacion→Maquina→Explotacion）导致循环查询，这就是你看到大量SQL的原因。

解决方法：
替换@Data为更精准的Lombok注解，排除关联集合在自动生成的方法中：

@Entity
@NoArgsConstructor
@AllArgsConstructor
@Getter
@Setter
@Builder
@ToString(exclude = {"cultivos", "maquinas", "usuarios"})
@EqualsAndHashCode(exclude = {"cultivos", "maquinas", "usuarios"})
public class Explotacion {
    // 原有代码不变
}

对Maquina实体做同样处理：

@Entity
@NoArgsConstructor
@AllArgsConstructor
@Getter
@Setter
@Builder
@ToString(exclude = {"explotaciones"})
@EqualsAndHashCode(exclude = {"explotaciones"})
public class Maquina {
    // 原有代码不变
}

2. 确保在事务中访问懒加载集合 #

如果你的代码是在Controller层直接调用explotacionAux.getMaquinas()，此时EntityManager已经关闭，懒加载代理无法获取数据库连接初始化集合，可能返回空集合。

解决方法：
将业务逻辑放到Service层，添加@Transactional注解保证事务上下文：

@Service
@Transactional
public class ExplotacionService {
    @Autowired
    private ExplotacionRepository explotacionRepository;

    public Set<Maquina> getMaquinasByExplotacionId(Long id) {
        Optional<Explotacion> explotacion = explotacionRepository.findById(id);
        return explotacion.map(Explotacion::getMaquinas).orElse(Collections.emptySet());
    }
}

3. 用JOIN FETCH/EntityGraph解决N+1问题 #

即使修复了循环引用，懒加载单个集合仍会触发额外查询，用预加载可以一次性获取主实体和关联集合：

方式一：自定义查询用JOIN FETCH #

在ExplotacionRepository中添加：

@Query("SELECT e FROM Explotacion e JOIN FETCH e.maquinas WHERE e.id = :id")
Optional<Explotacion> findByIdWithMaquinas(@Param("id") Long id);

方式二：用EntityGraph预加载 #

在Repository方法上添加@EntityGraph：

@Repository
public interface ExplotacionRepository extends JpaRepository<Explotacion, Long> {
    @EntityGraph(attributePaths = {"maquinas"})
    Optional<Explotacion> findById(Long id);
}

4. 检查双向ManyToMany的关联维护 #

Maquina是ManyToMany关联的拥有方（因为它定义了@JoinTable），所以当你关联两个实体时，必须同时维护两边的集合，否则中间表maquina_explotacion不会被正确插入数据，导致查询返回空。

解决方法：
在Explotacion中添加关联维护方法：

public void addMaquina(Maquina maquina) {
    this.maquinas.add(maquina);
    maquina.getExplotaciones().add(this);
}

public void removeMaquina(Maquina maquina) {
    this.maquinas.remove(maquina);
    maquina.getExplotaciones().remove(this);
}

保存关联时调用这个方法：

Explotacion explotacion = new Explotacion();
Maquina maquina = new Maquina();
// 设置实体属性...
explotacion.addMaquina(maquina);
explotacionRepository.save(explotacion);

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