Spring Batch类型转换错误：UnmodifiableMap转JobParameters失败

问题现象 #

在Spring Batch任务执行时，出现类型转换错误：无法将java.util.Collections$UnmodifiableMap转换为org.springframework.batch.core.JobParameters，无匹配的编辑器或转换策略。具体表现为在CustomAdapter构造函数中使用@Value("#{jobParameters}")注入JobParameters时，触发org.springframework.beans.factory.UnsatisfiedDependencyException，导致Job执行失败。

错误原因 #

1. 注入方式错误：Spring Batch上下文里，#{jobParameters} EL表达式实际指向的是JobParameters内部存储的不可变参数Map（即UnmodifiableMap），而非JobParameters对象本身。使用@Value注入会获取到Map实例，自然无法转换为JobParameters类型。
2. JobParameters创建冗余：当前JobParametersFactory中通过new JobParameters(jobParametersBuilder.toJobParameters().getParameters())重新构建实例，虽然功能正常，但属于冗余操作，jobParametersBuilder.toJobParameters()已经返回合法的JobParameters实例。

修复方案 #

1. 替换注入方式为Spring Batch专用注解 #

将CustomAdapter构造函数中的@Value("#{jobParameters}")替换为Spring Batch提供的@JobParameters注解，该注解会直接注入JobParameters实例。

2. 简化JobParameters创建逻辑 #

删除JobParametersFactory中冗余的实例构建步骤，直接返回jobParametersBuilder.toJobParameters()生成的实例。

代码调整示例 #

调整后CustomAdapter.java

public CustomAdapter(ServerSideEventRegistration sseRegistry,
                     ExportStoreManager storeManager,
                     @JobParameters JobParameters parameters) {
    // 构造函数逻辑
}

调整后JobParametersFactory.java

public JobParameters createJobParameters(BulkJobParameters bulkParams) {
    try {
        JobParametersBuilder jobParametersBuilder = new JobParametersBuilder();
        jobParametersBuilder.addJobParameter(KEY_BULK_ID, createBulkIdentifierParameter(bulkParams.getBulkRequestId()));
        jobParametersBuilder.addJobParameter(KEY_USER_NAME, createNonIdParam(bulkParams.getUserName()));
        jobParametersBuilder.addJobParameter(KEY_DISPLAY_NAME, createNonIdParam(bulkParams.getDisplayName()));
        final String requestAsString = objectMapper.writeValueAsString(bulkParams.getRequest());
        jobParametersBuilder.addJobParameter(KEY_REQUEST, createNonIdParam(requestAsString));
        // 直接返回构建好的JobParameters实例，无需重新包装
        return jobParametersBuilder.toJobParameters();
    } catch (JsonProcessingException e) {
        log.error("Failure serializing request {}" , bulkParams.getRequest(), e);
        throw new BulkJobException(e, bulkParams.getRequest());
    }
}

验证说明 #

调整后重新启动Job，Spring Batch会通过@JobParameters正确注入JobParameters实例，不再出现类型转换异常；同时简化后的JobParameters创建逻辑更高效，避免了不必要的Map包装操作。

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