Spring Boot 3.1.X升级后Spring Batch步骤执行报错求助

核心原因定位 #

SQLCODE=-407是DB2的空值违反非空约束错误，本质是某NOT NULL列被插入了空值。结合Spring Batch 5升级场景，优先排查元数据表配置或业务数据处理逻辑。

具体排查与修复步骤 #

1. 先确定异常触发的表和列 #

从异常堆栈的SQLERRMC字段提取关键信息，格式类似：

SQLERRMC=COLUMN_NAME,TABLE_SCHEMA.TABLE_NAME

比如如果是BATCH_JOB_EXECUTION.JOB_EXECUTION_ID，说明是元数据表的主键生成问题；如果是业务表，则聚焦业务代码逻辑。

2. 元数据表相关问题修复 #

如果异常来自Spring Batch元数据表：

• 核对元数据表结构：严格对照Spring Batch 5官方提供的DB2元数据表脚本，确保所有列的NOT NULL约束、数据类型、序列关联完全一致。重点检查：
  • BATCH_JOB_INSTANCE的JOB_KEY、JOB_NAME是否为NOT NULL
  • BATCH_JOB_EXECUTION、BATCH_STEP_EXECUTION的主键列是否关联了正确的序列
• 修正JobRepository主键生成策略：自定义DefaultBatchConfiguration时，必须显式配置DB2兼容的增量器，否则默认策略可能无法正确生成主键值：

  @Configuration
  public class ReportBatchConfiguration extends DefaultBatchConfiguration {
  
      @Autowired
      private DataSource dataSource;
  
      @Override
      protected JobRepository createJobRepository() throws Exception {
          JobRepositoryFactoryBean factory = new JobRepositoryFactoryBean();
          factory.setDataSource(dataSource);
          factory.setTransactionManager(getTransactionManager());
          factory.setDatabaseType("DB2");
          // 指定你创建的序列名称，需与实际DB中序列名一致
          factory.setIncrementer(new Db2MaxValueIncrementer(dataSource, "BATCH_SEQ"));
          factory.setTablePrefix("BATCH_");
          return factory.getObject();
      }
  
      // 其他重写方法...
  }
  

• 验证序列可用性：手动执行DB2语句检查序列是否正常生成值：

  SELECT NEXT VALUE FOR BATCH_SEQ FROM SYSIBM.SYSDUMMY1;
  

  同时确保应用数据库用户拥有该序列的SELECT权限。

3. 业务表相关问题修复 #

如果异常来自业务表：

• 检查对应ItemWriter/ItemProcessor逻辑，确认是否有字段被设置为空值，而该字段在业务表中定义为NOT NULL
• 排查Spring Boot升级后依赖组件的行为变化：比如MyBatis/Hibernate的字段映射规则、默认值处理是否有调整，导致原本有默认值的字段变为空

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