Spring Boot中@Query能否处理返回非表结构的SQL查询？

非表结构结果的查询方案（无需额外建实体） #

当查询聚合值（如平均值）这类非完整实体结构的结果时，完全不需要创建新实体类，以下是几种实用方案：

1. 直接返回基本类型/包装类 #

针对单一聚合结果，直接指定返回类型为对应包装类即可，SQL中注意使用数据库实际列名：

@Query(value = "select avg(Salary) from employee_table", nativeQuery = true)
Double getAverageSalary();

2. 返回Map<String, Object> #

如果需要同时获取多个聚合值，用Map存储结果，键为SQL中定义的别名：

@Query(value = "select avg(Salary) as avg_salary, max(Salary) as max_salary from employee_table", nativeQuery = true)
Map<String, Object> getSalaryStats();

使用时通过map.get("avg_salary")直接取值。

3. 投影接口（类型安全推荐） #

定义一个接口，声明对应结果字段的getter方法，Spring Data会自动封装结果：

// 投影接口
public interface SalaryProjection {
    Double getAvgSalary();
    Integer getMaxSalary();
}

// Repository层
@Query(value = "select avg(Salary) as avgSalary, max(Salary) as maxSalary from employee_table", nativeQuery = true)
SalaryProjection getSalaryStats();

这种方式兼具类型安全和灵活性，比Map更易维护。

"Column not found"异常解决 #

你遇到的SQLGrammarException本质是Spring Data映射结果时找不到匹配的字段，即使数据库执行SQL正常，映射阶段仍会报错：

• 检查SQL中的列名是否与数据库实际列名完全一致（比如你的数据库列是Salary，不要写成小写的salary，部分数据库对大小写敏感）
• 聚合查询必须给结果设置别名，且别名要和返回对象（或投影接口）的字段名匹配（比如投影接口的getAvgSalary()对应SQL里的as avgSalary）
• 如果是返回部分实体字段的查询，确保查询的字段别名与实体类@Column注解的name属性一致

举个修复后的聚合查询示例：

// 正确写法：别名与投影接口方法名对应
@Query(value = "select avg(Salary) as avgSalary from employee_table", nativeQuery = true)
SalaryProjection getAverageSalary();

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