Eclipselink 2.5.2迁移至4.0.2后DB2并发语句超限问题排查

错误本质 #

你遇到的NULLID.SYSLH103 0X5359534C564C3031是DB2的典型报错，核心原因是DB2系统包NULLID.SYSLH103容量耗尽——这个包用于存储应用打开的预编译SQL语句，当同时打开的预编译语句数量超过包的可用空间时就会触发该错误。

从报错信息中同一个INSERT语句被打开1338次的情况来看，Eclipselink的语句缓存未按预期工作，每次循环调用save()都创建了新的预编译语句，而非复用缓存中的语句。

Eclipselink 4.x版本的关键变更 #

从2.5.2升级到4.0.2后，语句缓存与批处理机制有以下重要调整：

• 语句缓存默认行为变化：2.5.x版本默认会启用语句缓存并设置了默认缓存大小，而4.x版本中eclipselink.jdbc.cache-statements=true仅开启缓存开关，但默认缓存大小为0，导致语句无法被有效复用。
• JDBC批处理逻辑优化：4.x对JDBC批处理的实现做了调整，若语句缓存未正确配置，批处理会退化为单条语句执行模式，大量创建新的预编译语句。

解决方案 #

1. 完善语句缓存配置 #

在现有配置中添加语句缓存大小参数，确保Eclipselink能复用预编译语句：

<prop key="eclipselink.jdbc.cache-statements.size">500</prop>

该值可根据业务场景调整（比如设置为1000），需大于你的批处理最大并发语句数。

2. 优化代码写法 #

避免循环调用save()，改用saveAll()批量提交，Spring Data JPA的saveAll()会更高效地利用Eclipselink的批处理机制，减少语句创建：

List<Table1> entities = new ArrayList<>();
for (Table1Dto iterator : records) {
    Table1 tab = new Table1();
    tab.setData(iterator.getData());
    entities.add(tab);
}
repo.saveAll(entities);
repo.flush();

3. 修正重复的日志配置 #

你的配置中重复设置了eclipselink.logging.level，后设置的FINE会覆盖前面的SEVERE，建议保留统一的日志级别，方便调试语句缓存行为：

<prop key="eclipselink.logging.level">FINE</prop>
<prop key="eclipselink.logging.level.sql">FINE</prop>

4. 数据库层面兜底方案（可选） #

若应用配置调整后仍有问题，可联系DBA增大DB2的NULLID.SYSLH103包大小，执行以下SQL：

ALTER PACKAGE NULLID.SYSLH103 RESIZE PACKAGE(1000);

数值可根据实际需要调整，增大包的可用空间。

验证方法 #

调整配置后，开启SQL日志，观察批量插入时是否仅创建一次INSERT预编译语句，而非每次循环都创建新语句，以此确认语句缓存生效。

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