Spring Data JPA原生查询报错SQLState:42601，SQL客户端可正常执行

核心问题分析 #

你碰到的SQLState: 42601是PostgreSQL的语法错误，虽然这条SQL在客户端能正常执行，但结合代码来看，问题根源是返回类型与查询结果集不匹配：

你的查询是从book表查询所有数据行（FROM book a），但方法返回的是Optional<ResultDto>——Optional仅用于包装单条结果，JPA在处理这种矛盾时会自动拼接额外的SQL逻辑，最终导致SQL解析失败，抛出语法错误。

修复方案 #

方案1：适配多结果返回 #

如果需要查询所有符合条件的数据，直接把方法返回类型改为List<ResultDto>即可：

@Query(value = "SELECT a.id AS id, " +
        "a.key_1 AS key1, " +
        "a.key_2 AS key2, " +
        "a.total AS total, " +
        "a.modify_date AS modifyDate, " +
        "(SELECT COUNT(x.key_1) FROM book x WHERE x.key_1 = a.key_1) AS bookByKey1 " +
        "FROM book a", nativeQuery = true)
List<ResultDto> findAllByBookByKey1();

方案2：强制单结果返回 #

如果确实只需要单条结果，在SQL末尾添加LIMIT 1，同时保留Optional<ResultDto>返回类型：

@Query(value = "SELECT a.id AS id, " +
        "a.key_1 AS key1, " +
        "a.key_2 AS key2, " +
        "a.total AS total, " +
        "a.modify_date AS modifyDate, " +
        "(SELECT COUNT(x.key_1) FROM book x WHERE x.key_1 = a.key_1) AS bookByKey1 " +
        "FROM book a LIMIT 1", nativeQuery = true)
Optional<ResultDto> findAllByBookByKey1();

额外验证点 #

• 确认ResultDto的字段名与查询中的别名完全匹配（比如id、key1、key2等字段必须存在，且数据类型对应）
• 检查项目中是否有自定义的JPA配置，是否会干扰原生SQL的解析逻辑

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