Spring Data JPA Repository join查询返回null而非空集合问题排查

1. 前两种查询使用默认内连接逻辑
   JPQL中未显式指定连接类型的join/join fetch均为内连接，内连接要求主表（User）和关联表（favoriteRestos）都存在匹配记录才会返回结果。如果目标用户没有关联的收藏餐厅数据，连表结果中不会包含该用户的行，ORM框架会直接返回null。
2. 第三种左连接写法未匹配抓取需求
   普通left join仅用于声明关联查询逻辑，不会主动加载favoriteRestos集合，该集合仍为懒加载代理对象。若实体配置了软删除@Where、全局过滤@Filter等规则，或是在持久化上下文外访问集合，可能触发异常，核心问题是需要使用左连接+关联抓取的组合逻辑，而非普通左连接。

使用left join fetch关键字声明左外连接抓取关联集合即可，写法如下：

@Query("select u from User u left join fetch u.favoriteRestos where u.id = ?1")
User findByIdWithFavoriteRestos (Long userId);

该写法完全符合预期效果：

• 左外连接逻辑保证只要对应用户存在，无论是否有关联的收藏餐厅，都会返回User实体，不会返回null
• fetch关键字会在一次SQL查询中同时加载User和对应的favoriteRestos集合，避免懒加载异常
• 若用户无收藏记录，返回的User实体中favoriteRestos会是空集合，而非null

如果需要对关联的收藏餐厅加过滤条件，可给关联集合加别名，例如筛选未删除的收藏：

@Query("select u from User u left join fetch u.favoriteRestos s where u.id = ?1 and s.isDeleted = false")
User findByIdWithValidFavoriteRestos (Long userId);

内容的提问来源于stack exchange，提问作者Nunyet Calçada