Postgres原生SQL执行正常，JPA @Query原生查询返回空结果是什么原因？

• 移除SQL最外层多余括号
  直接在Postgres中执行包裹最外层括号的SQL无语法问题，但部分JPA实现的原生SQL解析器、JDBC驱动对最外层带括号的查询存在兼容问题，会导致结果返回异常。可修改@Query中的SQL，直接以select开头，删除最外层的()包裹即可。
• 核对实体字段映射规则
  原生查询默认不会自动开启下划线转驼峰的命名转换，若数据库表字段为下划线命名（如layout_id），而Layout实体属性为驼峰命名（如layoutId），会导致查询结果无法映射到实体，最终返回空列表。两种解决方案：
  1. 给查询字段添加和实体属性名一致的别名，例如select layout_id as layoutId, [其他字段] from layout ...
  2. 配置JPA原生查询命名策略，全局开启下划线转驼峰映射
• 确认数据源与数据可见性
  检查代码连接的数据源是否和手动执行SQL的为同一数据库、同一schema，避免出现开发库/测试库混淆、表所属schema不匹配的问题。同时确认手动验证的测试数据已完成事务提交，代码侧事务可正常读取对应数据。
• 校验实际执行的SQL与参数
  开启JPA SQL打印配置（Spring Boot项目可配置spring.jpa.show-sql=true、spring.jpa.properties.hibernate.format_sql=true），查看代码实际执行的SQL语句、传入参数值是否符合预期，排查是否存在参数类型不匹配（例如数据库region_id为字符串类型、代码传入Integer导致隐式转换失败）、SQL拼接异常的问题。
• 检查实体类定义合规性
  确认Layout实体类包含public无参构造函数，@Table注解指定的表名正确，没有配置错误的数据源路由、多租户隔离等规则导致查询结果被过滤。

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