Spring Batch 4.x迁移至5.x：ChunkContext读取JobParameter异常求助

核心原因 #

Spring Batch 5.x对StepContext.getJobParameters()的返回值做了关键变更：

• 4.x版本返回Map<String, Object>，值是参数的实际内容（比如你存入的JSON字符串）
• 5.x版本返回Map<String, JobParameter>，值是JobParameter对象实例，直接toString会输出包含value、type、identifying的结构字符串，这就是你反序列化失败的直接原因。

快速修复方案 #

方案1：从JobParameter对象提取实际值 #

修改Tasklet中获取参数的代码，先拿到JobParameter实例再调用getValue()方法获取真实内容：

// 原错误代码
// String jsonStr = (String) chunkContext.getStepContext().getJobParameters().get("job-params");

// 修复后代码
JobParameter jobParam = (JobParameter) chunkContext.getStepContext().getJobParameters().get("job-params");
String jsonStr = (String) jobParam.getValue();
// 后续Gson反序列化逻辑保持不变

方案2：通过JobExecution获取原生参数 #

绕过StepContext的参数映射，直接从JobExecution中读取原生JobParameters，这种方式更稳定：

JobExecution jobExecution = chunkContext.getStepContext().getStepExecution().getJobExecution();
String jsonStr = jobExecution.getJobParameters().getString("job-params");

针对“仅特定字段异常”的排查方向 #

如果只有两个字段出现问题，重点检查以下几点：

• 检查这两个字段的JobParametersBuilder构建代码：是否误用了addParameter手动创建JobParameter，而非使用addString/addLong等类型专属方法？错误写法会导致参数类型识别异常：

  // 错误示例：手动创建JobParameter可能引发类型处理问题
  builder.addParameter("special-field", new JobParameter(specialValue));
  // 正确写法：使用匹配参数类型的方法
  builder.addString("special-field", specialValue);
  

• 排查项目中是否存在自定义的JobParameterConverter或参数处理扩展类，迁移后未适配5.x的API变更，导致这两个参数被特殊处理。
• 检查这两个参数是否被标记为非identifying参数？部分场景下非identifying参数的序列化逻辑可能与普通参数不同。

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