Spring Projections未返回州详情问题的解决求助

我之前也碰到过一模一样的情况，核心问题在于父投影需要显式引用子投影接口，同时要确保关联的子实体数据被正确加载（避免懒加载导致的空列表）。下面是一步步的解决方法：

1. 确保子投影（StateProjection）定义正确 #

首先你的StateProjection要只包含需要的州编码字段，方法名必须和State实体中对应属性的getter完全一致：

public interface StateProjection {
    // 对应State实体里的stateCode属性的getter方法名
    String getStateCode();
}

2. 修改父投影（CountryProjection）关联子投影 #

在CountryProjection里，除了国家的名称、编码，还要添加返回StateProjection列表的方法，方法名必须和Country实体中关联State的属性名匹配（比如你的Country实体里关联的属性叫states，那这里就用getStates()）：

public interface CountryProjection {
    String getCountryName();
    String getCountryCode();
    // 关联子投影，方法名要和实体中的关联属性名一致
    List<StateProjection> getStates();
}

3. 调整Repository查询，确保关联数据被加载 #

这里有两种方式，取决于你的关联关系是懒加载还是急加载：

方式一：用@Query手动指定JOIN FETCH #

如果你的Country实体中states是懒加载（默认@OneToMany是懒加载），Spring Data默认不会主动查询关联的states，这时候可以用自定义SQL强制加载关联数据：

public interface CountryRepository extends JpaRepository<Country, Long> {
    @Query("SELECT c FROM Country c JOIN FETCH c.states")
    Page<CountryProjection> findAllWithStatesProjected(Pageable pageable);
}

方式二：用@EntityGraph优化加载 #

如果不想写自定义SQL，也可以用@EntityGraph来指定加载关联的states，更简洁：

public interface CountryRepository extends JpaRepository<Country, Long> {
    @EntityGraph(attributePaths = "states")
    Page<CountryProjection> findAllProjectedBy(Pageable pageable);
}

4. 调整ServiceImpl中的调用 #

最后在你的CountryServiceImpl里，直接返回Repository查询到的Page<CountryProjection>即可：

@Override
public Page<CountryProjection> getAllCountryDetails(Pageable pageable) {
    return countryRepository.findAllWithStatesProjected(pageable);
    // 或者 return countryRepository.findAllProjectedBy(pageable);
}

关键注意点 #

• 投影接口的方法名必须和实体类的getter完全匹配，包括关联属性的名称，否则Spring Data无法映射数据。
• 懒加载的关联数据必须通过JOIN FETCH或者@EntityGraph强制加载，否则投影中的子实体列表会是空的或者null。
• 确保Country和State的关联关系配置正确，比如Country中的@OneToMany(mappedBy = "country") private List<State> states;，State中的@ManyToOne private Country country;映射无误。

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