使用@Query获取JPA延迟加载关联字段时查询无结果问题

你的问题出在JOIN FETCH是内连接上：如果目标Game的moves列表为空，这个查询会因为内连接的特性过滤掉该Game实体；而默认的findById是延迟加载逻辑，不管moves是否为空都会返回实体（只是moves会是懒加载代理对象）。

解决方法一：改用LEFT JOIN FETCH #

把JPQL里的JOIN改为LEFT JOIN，这样即使moves为空，也能正确返回Game实体：

public interface GameRepository extends CrudRepository<Game, Long> {
    @Query("SELECT g FROM Game g LEFT JOIN FETCH g.moves WHERE g.id = :id")
    Optional<Game> findByIdWithMoves(@Param("id") Long id);
}

解决方法二：使用@EntityGraph（更推荐） #

对于这种简单的关联字段加载需求，@EntityGraph比自定义JPQL更简洁，也不容易出错：

public interface GameRepository extends CrudRepository<Game, Long> {
    @EntityGraph(attributePaths = "moves")
    Optional<Game> findById(Long id);
}

如果需要保留自定义方法名，也可以这么写：

public interface GameRepository extends CrudRepository<Game, Long> {
    @EntityGraph(attributePaths = "moves")
    Optional<Game> findByIdWithMoves(Long id);
}

两种方式的适用场景 #

• @Query：适合复杂查询场景，比如需要多表关联过滤、自定义条件聚合等，必须手写JPQL的时候使用。
• @EntityGraph：适合简单的关联属性加载，代码更简洁，框架会自动处理关联查询，避免手动写JPQL的语法错误。

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