当在 spring data jpa 中用 `@query` 执行原生 sql 或 jpql 查询并返回多列结果时，若直接使用 `list
该问题本质源于 查询类型与返回类型不匹配：您在注解中写的是 JPQL（如 SELECT q.id as someId, q.name as someName FROM Quote q...），但 Spring Data JPA 默认将 @Query 视为 JPQL 查询——而 JPQL 不支持 AS 别名用于字段投影（尤其在多字段场景下），更不支持原生 SQL 的列别名语法；同时，若实际执行的是原生 SQL 却未声明 nativeQuery = true，JPA 会尝试将其解析为 JPQL，导致元数据解析失败，最终 Tuple 无法正确绑定字段，引发 IndexOutOfBoundsException: Index: 0, Size: 0。
✅ 正确做法是：统一使用 JPQL + 构造器表达式（Constructor Expression），显式调用 DTO 或 Tuple 的构造方法：
// 定义轻量级 DTO（必须有对应构造函数）
public class QuoteSummary {
private final Long someId;
private final String someName;
public QuoteSummary(Long someId, String someName) {
this.someId = someId;
this.someName = someName;
}
// getters...
}@Transactional(readOnly = true)
@Query("SELECT NEW com.example.YourPackage.QuoteSummary(q.id, q.name) " +
"FROM Quote q WHERE q.id IN :quoteIds")
List<QuoteSummary> selectSomeThings(@Param("quoteIds") List<Long> quoteIds);⚠️ 注意事项：
- NEW 关键字仅适用于 JPQL，且类路径必须完整（含包名），构造函数参数顺序需严格匹配 SELECT 字段顺序；
- 若坚持使用 Tuple，应确保使用 JPQL（非原生 SQL） 并避免 AS 别名（JPA 会自动按位置映射）：
@Query("SELECT q.id, q.name FROM Quote q WHERE q.id IN :quoteIds") List<Tuple> selectTuples(@Param("quoteIds") List<Long> quoteIds); // 使用时：tuple.get(0, Long.class), tuple.get(1, String.class) - 若必须用原生 SQL（如涉及复杂数据库函数），则务必添加 nativeQuery = true，并配合 @SqlResultSetMapping 或 ResultSetExtractor —— 但此时 Tuple 不再适用，需手动映射。
? 总结：升级 Spring Boot 后出现此问题，往往因新版本对 JPQL 解析更严格。规避风险的最佳实践是——优先使用构造器表达式返回不可变 DTO，语义清晰、类型安全、无需额外映射，也完全兼容 Spring Data JPA 的查询机制。
