JPA从另一张表取数更新目标表时结果集元数据提取失败如何解决

1 优先校验Repository层更新语句写法 #

• 确认更新方法是否加了@Modifying和@Transactional注解：JPA的更新/删除操作必须搭配@Modifying注解，否则Hibernate会默认按查询逻辑解析SQL，尝试提取结果集元数据，就会触发你遇到的报错。如果是调用方统一加事务，至少要在Repository的更新方法上标注@Modifying
• 检查注解的nativeQuery属性是否正确：如果写的是原生Oracle SQL，必须加nativeQuery = true，否则Hibernate会按JPQL语法解析，生成的SQL不符合Oracle规范，直接报ORA-00900
• 检查SQL语句本身的语法错误：可以把打印出的SQL直接复制到Oracle客户端执行，确认是否有语法问题，比如占位符写错、关键字拼写错误、表/视图名写错、权限不足等常见问题

2 确认返回值配置是否正确 #

• 如果你在更新方法上定义了非void、非Integer/int的返回值，比如返回自定义实体或者Map，就会导致Hibernate尝试解析更新后的返回结果集。更新操作的返回值只能是void或者受影响的行数（int/Integer类型），如果你需要获取更新后的数据，应该先执行更新，再单独走查询逻辑获取
• 你用Map接收查询视图的逻辑是没问题的，注意不要把查询和更新的返回值逻辑搞混，更新方法不要定义Map类型的返回

3 检查Hibernate相关配置 #

• 开启SQL打印配置，确认实际执行的更新语句是否符合预期：在配置文件中添加spring.jpa.show-sql=true、spring.jpa.properties.hibernate.format_sql=true，打印出的SQL和参数可以直接拿到Oracle端验证，快速定位语法问题
• 确认Oracle方言配置是否正确：必须配置spring.jpa.database-platform=org.hibernate.dialect.Oracle12cDialect（对应你实际的Oracle版本），方言配置错误会导致Hibernate生成不符合Oracle规范的SQL

4 特殊场景排查 #

• 如果你的更新语句用到了动态SQL，比如用@Query写了带条件判断的语句，或者用了Specification拼接更新逻辑，要确认拼接后的SQL没有语法问题，比如多了逗号、少了空格等
• 检查你操作的表是否有触发器、行级安全策略，这类规则如果配置错误，也可能在执行更新时触发ORA-00900错误

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