Spring Data JPA @EntityGraph在findById方法中不生效问题排查

问题本质：版本相关Bug #

你遇到的问题确实是Spring Data JPA和Hibernate在特定版本组合中的已知问题：在**Spring Boot 3.1.x（对应Hibernate 6.2.x）**中，JpaRepository自带的findById等基础单实体查询方法，无法正确应用@EntityGraph(attributePaths)配置，导致关联实体（如Board.user）不会被通过fetch join加载；而自定义查询、分页查询等方法则不受影响。

该问题在**Spring Boot 3.2.0（对应Hibernate 6.3.x）**中已被官方修复，升级后findById方法会正确生成包含关联实体的left join查询。

旧版本（Spring Boot 3.1.x/Hibernate 6.2.x）解决方案 #

如果暂时无法升级版本，可通过以下方式解决：

1. 自定义带@Query的查询方法替代原生findById #

通过显式编写JPQL查询，配合@EntityGraph强制加载关联实体：

@Repository
public interface BoardJpaRepository extends JpaRepository<Board, Long> {
    @EntityGraph(attributePaths = {"user"})
    @Query("select b from Board b where b.id = :id")
    Optional<Board> findByIdWithUser(@Param("id") Long id);
}

2. 显式指定EntityGraph的Type属性 #

尝试显式设置type = EntityGraph.EntityGraphType.FETCH，部分场景下可触发正确的fetch join逻辑：

@Repository
public interface BoardJpaRepository extends JpaRepository<Board, Long> {
    @EntityGraph(attributePaths = {"user"}, type = EntityGraph.EntityGraphType.FETCH)
    Optional<Board> findById(Long id);
}

3. 在JPQL中直接使用fetch join #

无需依赖@EntityGraph，直接在查询语句中声明fetch join：

@Repository
public interface BoardJpaRepository extends JpaRepository<Board, Long> {
    @Query("select b from Board b join fetch b.user where b.id = :id")
    Optional<Board> findByIdWithUser(@Param("id") Long id);
}

以上三种方式均可在旧版本中强制实现关联实体的一次性加载，避免仅查询主实体的问题。

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