JPA原生查询List嵌套对象属性报错的解决方法

你遇到的No property victoryScore found for type User!错误源于SQL语法混用：

• 声明nativeQuery = true时需要编写数据库层面的原生SQL，但你写的JOIN u.userStats us是JPQL的实体关联语法，原生SQL不识别Java实体的属性关联关系，JPA解析阶段会错误尝试在User实体上查找victoryScore属性，最终抛出找不到属性的异常。
• 除此之外你的初始写法还存在逻辑漏洞：直接关联userStats表会匹配到用户关联的2条UserStats记录，既会返回重复User结果，也无法精准匹配你需要的userStats.get(0)对应记录的分数区间。

该需求完全可以实现，以下两种方案可按需选择： #

方案1：使用JPQL查询（推荐，代码最简洁） #

移除nativeQuery = true配置，直接使用JPA支持的JPQL语法编写关联查询，同时加上索引匹配条件固定取第一个UserStats记录：

@Query(
    value = "SELECT DISTINCT u FROM User u " +
            "JOIN u.userStats us " +
            "WHERE u.location = :location " +
            "AND u.rating BETWEEN :lowerRatingBound AND :upperRatingBound " +
            "AND INDEX(us) = 0 " +
            "AND us.victoryScore BETWEEN :lowerVictoryScoreBound AND :upperVictoryScoreBound"
)
List<User> findChallengingUsers(@Param("lowerRatingBound") Integer lowerRatingBound,
                                @Param("upperRatingBound") Integer upperRatingBound,
                                @Param("lowerVictoryScoreBound") Double lowerVictoryScoreBound,
                                @Param("upperVictoryScoreBound") Double upperVictoryScoreBound,
                                @Param("location") String location);

注意点：

• 加DISTINCT是为了避免EAGER关联策略下返回重复的User结果
• INDEX(us) = 0用于固定匹配List中第一个位置的UserStats实体，和你业务中user.getUserStats().get(0)的取值逻辑完全对应

方案2：使用原生SQL查询（适合需要调用数据库专属语法的场景） #

如果坚持使用原生查询，必须按照数据库表的实际关联逻辑编写SQL，不能使用实体属性点关联的JPQL写法，同时需要加条件区分出你要取的第一条UserStats记录。

你当前的UserStats实体中isLeagueUserStats字段可以作为区分标识，约定第0条记录和第1条记录的字段取值即可；如果没有明确标识，建议新增专门的排序/位置字段。

原生SQL写法示例：

@Query(
    value = "SELECT DISTINCT u.* FROM user u " +
            "JOIN user_stats us ON u.id = us.user_id " +
            "WHERE u.location = :location " +
            "AND u.rating BETWEEN :lowerRatingBound AND :upperRatingBound " +
            "AND us.is_league_user_stats = false " + // 替换为你实际区分第一条记录的条件
            "AND us.victory_score BETWEEN :lowerVictoryScoreBound AND :upperVictoryScoreBound",
    nativeQuery = true
)
List<User> findChallengingUsers(@Param("lowerRatingBound") Integer lowerRatingBound,
                                @Param("upperRatingBound") Integer upperRatingBound,
                                @Param("lowerVictoryScoreBound") Double lowerVictoryScoreBound,
                                @Param("upperVictoryScoreBound") Double upperVictoryScoreBound,
                                @Param("location") String location);

注意点：

• 原生SQL中要写数据库实际的字段名（比如JPA默认驼峰转下划线后的victory_score、is_league_user_stats），不能写Java实体的驼峰属性名

注意：JPA持久化的List集合默认不保证返回顺序，如果要稳定通过INDEX(us)拿到固定位置的记录，必须给User实体的userStats字段加上排序规则，示例：

@OneToMany(fetch = FetchType.EAGER, mappedBy = "user", cascade = CascadeType.PERSIST)
@OrderBy("userStatsId ASC")
private List<UserStats> userStats;

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