Spring Boot 中使用原生 SQL 查询的正确方式

在 spring boot 的 jpa 中，若需执行包含子查询、自定义函数或数据库特有语法的 sql，必须显式声明 `nativequery = true`，否则 hibernate 会尝试将其解析为 jpql，导致语法错误（如误报 `from` 后括号非法）。

Spring Data JPA 默认将 @Query 中的语句视为 JPQL（Java Persistence Query Language），它面向实体对象而非数据库表，不支持子查询别名（如 AS travelA_query）、原生函数调用（如 com.example.imse22.model.TrvlA_Cust_Dto(...)）或数据库特定语法。你提供的 SQL 是标准的 原生 PostgreSQL 查询，因此必须明确告知 JPA：这不是 JPQL，而是直接交由数据库执行的原生 SQL。

✅ 正确写法如下（关键修改：添加 value = ... 和 nativeQuery = true）：

@Query(
    value
 = "SELECT com.example.imse22.model.TrvlA_Cust_Dto(books_query.name, COUNT(travelA_query.customer_id)) " +
            "FROM (SELECT DISTINCT customer_servant.employee_id, books.customer_id " +
            "      FROM customer_servant " +
            "      INNER JOIN books ON customer_servant.employee_id = books.customer_servant_id) AS travelA_query " +
            "INNER JOIN " +
            "(SELECT travel_agency.id, travel_agency.name, employee.employee_id " +
            " FROM travel_agency " +
            " INNER JOIN employee ON travel_agency.id = employee.travel_agency_id) AS books_query " +
            "ON travelA_query.employee_id = books_query.employee_id " +
            "GROUP BY books_query.name", 
    nativeQuery = true
)
List findTravelAgencyCustomerStats();

⚠️ 注意事项：

• nativeQuery = true 是强制要求，缺省即触发 JPQL 解析，必然报错（如 unexpected token: (）；
• value 属性必须显式指定（不可省略 value =），否则编译器可能误解参数顺序；
• 聚合函数 COUNT() 拼写已修正（原查询中误写为 GROUOP BY → 应为 GROUP BY，且分组字段应与 SELECT 中非聚合字段一致：此处应为 books_query.name，因 travelA_query.name 并未在子查询中定义）；
• 返回类型建议使用 List，并确保 TrvlA_Cust_Dto 具备对应构造函数或通过 @SqlResultSetMapping 映射（若 DTO 非实体）；
• 若 DTO 构造函数需被数据库调用（如 TrvlA_Cust_Dto(name, count)），PostgreSQL 必须已注册该函数；更推荐做法是：先查出原始字段，再在 Java 层封装——即改用 Object[] 或 Tuple 返回，再手动构造 DTO。

? 小结：JPA 的 @Query 是双模引擎——JPQL（默认）用于面向对象查询，原生 SQL（需 nativeQuery = true）用于高性能/复杂场景。识别语法归属、显式声明模式，是避免“unexpected token”类错误的核心原则。