Spring JPA Query getResultList在Web应用中返回数据异常问题

这种集成测试跑通但Web应用里掉链子的情况真的很闹心，我帮你梳理几个最可能的原因和排查方向，你可以逐一验证：

1. EntityManager上下文与事务差异 #

集成测试里的EntityManager往往是为测试量身配置的，和Web环境的可能有本质区别：

• 事务管理不同：测试中通常会自动开启并提交事务，确保查询能拿到最新数据；但Web环境里如果事务配置不对（比如查询在无事务的上下文执行，或者事务未正确提交），可能导致EntityManager处于异常状态，无法正常执行查询
• EntityManager获取方式：如果你的getEntityManager()是手动实现的（不是通过@PersistenceContext注入），要注意EntityManager本身不是线程安全的！Web环境是多线程的，这种手动获取很可能导致线程间上下文混乱，而测试一般是单线程执行，所以没问题

2. 数据库环境差异 #

测试库和Web环境的数据库大概率不是同一个，这里容易踩坑：

• 表结构不一致：测试库的表结构是最新的，但Web环境的库可能没同步更新，比如原生SQL依赖的某个字段在Web库中不存在，或者字段类型不匹配（比如测试用int，Web库是bigint）
• 数据库权限问题：Web环境的数据库用户可能没有执行该原生SQL的权限（比如无法访问关联表），而测试用的是超级用户，自然没问题
• SQL语法兼容问题：如果测试用的是H2这类内存库，Web用的是MySQL/PostgreSQL，原生SQL的语法细节可能有差异（比如字符串拼接、日期函数），测试能跑但Web环境报错

3. 结果集映射（PermissionQueryMapping）配置问题 #

你用了命名的结果集映射，这部分很容易在环境切换时出问题：

• 检查Web环境的配置文件（比如orm.xml）是否正确包含了PermissionQueryMapping的映射定义，会不会测试环境的配置里有，但Web环境的配置漏掉了？
• 核对映射的字段和PermissionQueryDTO的属性是否完全匹配：比如SQL返回的列名、映射里指定的字段名，是不是和DTO的属性名一一对应？大小写、拼写错误都可能导致映射失败

4. 参数传递的隐藏问题 #

虽然方法参数是int，但Web环境的参数来源可能有坑：

• 如果Web层（比如Controller）接收的参数是可空类型（比如Integer），当前端没传值时会传入null，自动装箱成int时会抛出NullPointerException，而测试里你肯定传的是合法的int值，所以不会触发
• 检查Web环境中传入的参数值是否超出数据库字段的范围：比如数据库里companyId是smallint，但Web环境传入的数值超过了范围，测试用的都是小数值，自然没问题

最有效的排查手段：打SQL日志 #

直接看Web环境里实际执行的SQL和参数，对比测试环境的日志，差异一眼就能看出来：
在Spring Boot项目里，只需要在application.properties/application.yml里加这两行配置：

logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE

这样就能看到完整的SQL语句和绑定的参数值，到底是SQL写错了，参数传错了，还是数据库不兼容，一目了然

快速验证步骤 #

1. 临时把Web环境的数据库连接改成测试用的内存库（比如H2），跑相同的请求，如果正常，说明问题出在Web环境的数据库上
2. 直接在Web环境的数据库客户端里执行该原生SQL，传入相同的参数，看能不能正常返回结果，排除SQL本身的问题
3. 对比测试环境和Web环境的Spring配置，重点看EntityManagerFactory、事务管理器、结果集映射的配置是否一致

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