Quarkus使用Hibernate Panache查询时出现OutOfMemoryError错误求助

1. 优先处理磁盘溢出关联错误 #

你提供的错误日志明确指向Pod磁盘空间不足，该问题会直接触发内存溢出：

• 检查OpenShift Pod的临时存储配额，若开启了SQL日志、参数绑定日志，高并发请求下日志会快速占满磁盘；日志框架的异步输出队列在磁盘满后，会堆积大量未输出的日志事件在堆内存，直接触发OOM。
• 确认是否开启了OOM自动堆Dump，堆Dump文件写入Pod本地磁盘会快速占满存储配额，同时未写入完成的Dump关联的内存对象无法被GC回收。
• 临时解决方案：扩容Pod临时存储，关闭非必要的Debug级别日志，将堆Dump路径指向外部挂载的持久化存储。

2. Panache查询内存泄漏排查 #

排除磁盘问题后，针对堆内存持续上涨不回落的问题，按以下方向排查：

• 关联对象加载冗余：你的业务实体有105个属性，若配置了大量@OneToMany/@ManyToMany的EAGER加载规则，每次查询会全量拉取关联对象到内存，且未关闭的Session会一直持有这些对象无法释放。
  解决方案：非必要关联属性统一设置为LAZY加载，需要关联数据时用fetch join按需加载。
• Session上下文泄漏：Quarkus默认请求域Session会在请求结束后自动关闭，若手动管理Session生命周期、或者事务配置错误（如事务未正常提交/回滚），会导致Session持有一级缓存的所有实体无法被GC。
  解决方案：所有数据库操作都放在声明式事务边界内，不要手动打开/关闭Session，确认配置项quarkus.hibernate-orm.session.close-on-transaction-completion为默认值true。
• 查询计划缓存爆炸：若你的查询存在动态拼接条件，每个不同的查询语句都会生成新的查询计划存入缓存，无限膨胀后占满堆内存；即使in参数只有10种长度，叠加其他动态条件也会出现缓存量超标。
  解决方案：开启in参数填充优化，配置quarkus.hibernate-orm.query.in-clause-parameter-padding=true，不同长度的in条件可以复用同一个查询计划，减少缓存占用。
• 结果集过大：若未做分页，单次查询返回上千条带105个属性的实体，多次请求叠加后老对象未完成GC就会占满堆内存。
  解决方案：所有列表查询强制分页，单次返回条数不超过1000；大数据量导出场景使用Panache的stream方法滚动处理，不要一次性加载全量结果。

3. OpenShift环境差异化排查 #

开发环境无法复现问题时，重点对比两边的配置差异：

• 对比JVM参数：确认OpenShift上的堆内存配置-Xmx是否合理，是否远小于本地环境的配置；开启GC日志，确认内存溢出是老年代无法回收还是元空间溢出。
• 确认Quarkus运行配置：若生产环境开启了Hibernate二级缓存，未设置缓存过期策略和上限的情况下，缓存会无限膨胀导致OOM；本地开发模式默认会关闭二级缓存，因此不会复现问题。
• 检查构建镜像差异：确认生产构建的镜像是否包含多余的依赖、或者配置项与本地开发环境不一致。

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