JPA查询返回BoardGameInfo投影字段全为null但实体查询正常如何解决

问题原因 #

你遇到的投影全字段为null的问题，核心是Spring Data JPA的接口投影映射规则限制，和你的查询、投影定义不匹配导致的：

1. 投影定义中包含嵌套关联集合，但JPQL没有提前加载这些关联，懒加载的关联在映射时无法被正确读取，严重时会导致整个投影实例映射失败
2. 嵌套投影中直接返回实体类而非投影接口，Spring Data JPA无法完成自动映射
3. 部分低版本Spring Data JPA对基本类型和包装类的自动转换兼容不佳，也可能导致映射异常

解决步骤 #

1. 先验证基础字段映射是否正常
   先暂时删除BoardGameInfo中两个关联集合的getter方法，只保留基础字段的getter，测试是否能返回非null值，确认基础映射逻辑没有问题：

   public interface BoardGameInfo {
       long getId();
       long getBggId();
       String getDescription();
       int getMaxPlayerNumber();
       int getMaxTime();
       int getMinPlayerNumber();
       int getMinTime();
       String getName();
       String getPicture();
       long getTeseraId();
   }
   

2. 修正嵌套投影定义
   嵌套投影不能直接返回实体类，需要为关联的Collection也定义对应的投影接口，替换原有的实体返回类型：

   // 新增Collection投影
   public interface CollectionInfo {
       long getId();
       CollectionType getCollectionType();
       // 其他你需要的Collection字段的getter
   }
   
   public interface BoardGameInfo {
       // 基础字段getter
       Set<BoardGameCollectionInfo> getBoardGameCollections();
       Set<PlayInfo> getPlays();
   
       interface BoardGameCollectionInfo {
           CollectionInfo getCollection(); // 替换为投影类型而非实体
           Date getAdded();
       }
       interface PlayInfo {
           long getId();
       }
   }
   

3. 调整JPQL语句，提前加载关联
   使用left join fetch加载投影需要用到的关联集合，避免懒加载问题，同时加distinct去重：

   @Query("select distinct game from user u " +
           "inner join u.collections c " +
           "inner join c.boardGameCollection bgc " +
           "inner join bgc.boardGame game " +
           "left join fetch game.boardGameCollections bgcFetch " +
           "left join fetch game.plays pFetch " +
           "where u.id = ?1 and c.collectionType = ?2")
   List<BoardGameInfo> getBoardGameByCollectionTypeAndUserId(long userId, CollectionType type);
   

4. 可选优化
   给投影接口显式加上@Projection注解，明确指定关联的实体类型，避免包扫描导致的映射失效：

   @Projection(name = "boardGameInfo", types = BoardGame.class)
   public interface BoardGameInfo {
       // getter方法
   }
   

直接返回BoardGame实体正常的原因是实体由Hibernate直接管理，未加载的关联可以返回代理对象，不会影响基础字段的赋值；而投影是Spring Data JPA单独做的属性映射，只要有一处映射失败就可能导致整个实例的所有字段都被赋值为null。

内容的提问来源于stack exchange，提问作者Инга Куксова