Spring JPA原生查询用实体别名检索触发str_id列未在ResultSet中找到的报错

你碰到这个错的核心原因，是把JPQL的专属语法直接用到了原生SQL查询场景里，两者的解析规则完全不兼容：

• 你给@Query配置了nativeQuery = true，这时候注解里的SQL会被原封不动透传给PostgreSQL执行，JPA不会对语法做任何适配，完全走标准SQL的解析逻辑。
• 在JPQL语法体系里，SELECT u FROM 实体类 u是完全合法的写法，JPA会自动把它解析为“查询实体映射表的全部列，再把返回值映射成实体对象”。但这套写法放到原生SQL环境里完全不成立：
  PostgreSQL收到SELECT u FROM training_schema.exercise_entity u这类语句时，不会自动展开表的所有独立列，而是会把整行数据打包成一个复合类型返回。这时候ResultSet里根本没有str_id、str_exercise_name这些独立列，只有一个叫u的整行复合值。
• 后续JPA按照实体的映射规则，尝试从ResultSet里找str_id列填充到实体字段时，自然会抛出“找不到对应列”的错误。
• 你观察到的“空结果不报错”的现象也完全符合逻辑：当查询返回空ResultSet时，JPA会直接返回null，根本不会去解析ResultSet的列结构；只有存在实际返回行时，才会校验列映射关系，触发报错。
• 你一开始手写全列名的版本可以正常运行，是因为显式列出的独立列，刚好和实体映射的列名完全匹配，JPA可以正常完成值的映射。

完全不需要逐字手写所有列名，对应场景选方案就行，不用为了查全表费功夫敲十几二十个列名：

坚持用原生SQL的场景 #

把原SQL里的SELECT u改成标准原生SQL的全表展开写法SELECT u.*即可。PostgreSQL会自动展开表的所有独立列，返回的ResultSet结构和你手动写全所有列的效果完全一致，不会触发映射错误，示例代码：

@Query(value="SELECT u.* FROM training_schema.exercise_entity u WHERE u.str_exercise_name = ?1 and u.str_target_body_part= ?2", nativeQuery=true)
ExerciseEntity findExerciseEntityByNameAndTargetBodyPart(String str_exercise_name,String str_target_body_part);

查询完整实体的通用场景 #

如果你的目标就是查完整的实体对象，根本没必要开启nativeQuery=true。直接用默认的JPQL写法就行，JPA会自动生成对应映射的全列查询SQL，自动完成实体映射，写法更简洁也不会出现语法兼容问题，示例代码：

// 注意不要配置nativeQuery=true，默认就是JPQL解析模式
@Query("SELECT u FROM ExerciseEntity u WHERE u.strExerciseName = ?1 and u.strTargetBodyPart = ?2")
ExerciseEntity findExerciseEntityByNameAndTargetBodyPart(String strExerciseName, String strTargetBodyPart);

避坑提醒：别把JPQL专属的语法（比如面向实体的别名查询、关联对象查询的语法）直接搬到原生SQL的查询块里，原生SQL只认标准SQL语法，所有JPA层面的语法适配只在JPQL模式下生效。

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