从Hibernate 5迁移至Hibernate 6时出现“target lists最多1664条目”错误

问题场景 #

将应用从WildFly 26（基于Hibernate 5与JavaEE 8）迁移至WildFly 35（基于Hibernate 6与Jakarta EE 10）时，使用原有实体模型触发报错：

target lists can have at most 1664 entries

报错原因 #

• SQL生成逻辑变更：Hibernate 6对批量更新/删除、复杂JPQL查询的SQL生成策略做了调整，相比Hibernate 5，可能会将原本拆分的操作合并，生成包含更多字段/参数的SQL语句。而PostgreSQL对UPDATE/DELETE语句的目标条目数存在1664的内置限制，当生成的SQL超出该限制时就会触发此错误。
• 复杂实体映射的影响：若你的实体包含多字段关联、继承映射等复杂结构，Hibernate 6的查询解析器会生成比Hibernate 5更详尽的字段列表，容易突破PostgreSQL的条目上限。

相关文档查阅位置 #

• Hibernate 6迁移指南：官方迁移文档中专门有章节说明SQL生成策略、数据库兼容性的变更，可找到针对这类数据库限制的适配建议。
• Hibernate ORM 6官方文档：在「查询」「批量操作」章节，有关于SQL生成优化、数据库特定限制处理的详细说明。
• PostgreSQL官方文档：在「SQL语法」板块，明确标注了UPDATE语句目标字段列表的条目数上限规则。

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