Spring Batch SkipListener AOP配置报错：参数类型不匹配求助

可能的原因及对应解决办法 #

1. Spring版本兼容性问题 #

检查项目中Spring Batch与Spring Context/AOP的版本是否匹配，比如Spring Batch 4.x需对应Spring Framework 5.x，混用跨大版本组件会导致AOP代理逻辑异常。

• 解决：用Spring Boot父依赖统一管理所有Spring生态组件版本，避免手动指定不一致的版本号。

2. SkipListener方法签名隐性不匹配 #

SkipListener的三个核心方法（onSkipInRead/onSkipInProcess/onSkipInWrite）参数类型必须严格匹配处理链路的输入输出类型：

• 比如onSkipInProcess的第一个参数是ItemProcessor的原始输入对象，而非处理器返回的对象，若误用返回类型作为参数，会触发类型不匹配。
• 错误示例：

  // ItemProcessor输入为User，返回为UserDTO，但Listener错误用UserDTO作为参数
  @Override
  public void onSkipInProcess(UserDTO item, Throwable t) { ... }
  

• 正确示例：

  // 第一个参数为ItemProcessor的输入类型User
  @Override
  public void onSkipInProcess(User item, Throwable t) { ... }
  

3. Listener未被Spring容器正确管理 #

若SkipListener是手动new的实例（未加@Component或未在配置类中声明为@Bean），Spring Batch的AOP代理无法对其生效，进而触发代理逻辑错误。

• 解决：给SkipListener类添加@Component注解，或在Batch配置类中声明Bean后注册到Step：

  @Bean
  public Step sampleStep(ItemReader<User> reader, ItemProcessor<User, UserDTO> processor, ItemWriter<UserDTO> writer, SkipListener<User, UserDTO> skipListener) {
      return stepBuilderFactory.get("sampleStep")
              .<User, UserDTO>chunk(10)
              .reader(reader)
              .processor(processor)
              .writer(writer)
              .faultTolerant()
              .skip(Exception.class)
              .skipLimit(10)
              .listener(skipListener)
              .build();
  }
  

4. 自定义异常未纳入Skip规则 #

若手动抛出的自定义异常未继承Exception，或未在Step容错配置中指定该异常类型，Spring Batch无法识别为可跳过异常，会触发代理逻辑异常。

• 解决：确保自定义异常继承Exception，或在配置中明确指定：

  .faultTolerant()
  .skip(CustomProcessingException.class)
  .skipLimit(10)
  

5. 第三方AOP框架冲突 #

若项目引入了AspectJ等其他AOP框架，或自定义了AOP切面，可能与Spring Batch内置代理逻辑冲突。

• 解决：
  • 暂时禁用自定义切面，逐步排查冲突点；
  • 若使用AspectJ，在@EnableBatchProcessing中开启CGLIB代理：

    @EnableBatchProcessing(proxyTargetClass = true)
    

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