17370845950

本文详解如何在 spring data jpa 中正确编写 jpql 构造函数查询（constructor expression），重点解决因误用 nativequery、实体名大小写错误及属性名不匹配导致的常见异常。

在 Spring Data JPA 中，使用 SELECT new 语法调用 DTO 构造函数是实现类型安全投影（Type-Safe Projection）的常用方式。但该功能仅适用于 JPQL 查询，不支持原生 SQL（native query）。你遇到的 InvalidDataAccessResourceUsageException 异常，根本原因在于将 JPQL 语法（如 new com.xxx.dto.Class(...)）与 nativeQuery = true 错误混用——JDBC 驱动无法识别 new 关键字，从而抛出 SQL 解析失败。

✅ 正确做法如下：

1. 移除 nativeQuery = true：确保使用 JPQL（面向对象查询语言），而非原生 SQL；
2. 使用实体类名（非表名）：JPQL 操作的是 Java 实体，因此 FROM Smoke（首字母大写）才合法，FROM smoke（小写）会被 Hibernate 视为未声明的标识符；
3. 确保属性名与实体字段一致：例如实体中定义的是 smokedDate（驼峰命名），则 JPQL 中必须写 s.smokedDate，而非数据库列名 smoked_date；
4. DTO 构造函数参数类型需严格匹配 SELECT 表达式返回类型：SUM(s.quantity) 返回 Long（聚合结果默认为包装类型），因此构造函数形参应为 Long quantity，与你的 ActivityBasedQuantity 定义一致，无需修改。

修正后的完整代码如下：

@Query("SELECT new com.eminyilmazz.smoketracker.dto.ActivityBasedQuantity(s.activity, SUM(s.quantity)) " +
       "FROM Smoke s " +
       "WHERE s.smokedDate BETWEEN :beginDate AND :endDate " +
       "GROUP BY s.activity")
List getTotalQuantityGroupedByActivityWithMinuteInterval(
    @Param("beginDate") LocalDateTime beginDate,
    @Param("endDate") LocalDateTime endDate);

⚠️ 注意事项：

• 若 Smoke 实体中 activity 为 null，该行仍会参与分组（Hibernate 默认行为），如需排除空值，可添加 AND s.activity IS NOT NULL；
• SUM() 对空集合返回 null，若业务要求默认为 0，可在 DTO 构造函数中处理，或改用 COALESCE(SUM(s.quantity), 0L)（JPQL 支持）；
• 推荐配合 @Entity 中的 @Table(name = "smoke") 显式声明表名，避免混淆；但 JPQL 中永远引用类名，而非表名。

总结：JPQL 构造函数查询是高效、类型安全的轻量级投影方案，但必须严格遵循 JPQL 语法规则——以实体为中心、禁用 nativeQuery、注意命名大小写与驼峰映射。一次配置失误（如 nativeQuery = true）即可导致整个查询失效，排查时请优先核对这三项基础要素。