Spring Boot 3.2.x升级报错：ErrorHandler无法导入

核心原因 #

Spring Boot 3.2.x系列依赖的Spring Kafka版本为3.2.x（由Spring Boot依赖管控机制自动关联），而你当前手动指定的Spring Kafka 3.1.1与该版本存在兼容性冲突：

• 在Spring Kafka 3.2.x中，org.springframework.kafka.listener.ErrorHandler接口已被移除，取而代之的是org.springframework.kafka.listener.CommonErrorHandler接口（该替代接口在Spring Kafka 3.1.x中已引入，3.2.x正式淘汰旧接口）。

解决步骤 #

1. 对齐Spring Kafka版本
   移除pom.xml中手动指定的Spring Kafka版本，让Spring Boot依赖管理自动匹配对应版本（Spring Boot 3.2.1对应Spring Kafka 3.2.1），避免版本不一致问题：

   <!-- 移除手动指定的版本，由Spring Boot自动管控 -->
   <dependency>
       <groupId>org.springframework.kafka</groupId>
       <artifactId>spring-kafka</artifactId>
       <!-- <version>3.1.1</version> -->
   </dependency>
   

2. 替换错误处理接口
   将代码中所有ErrorHandler的引用替换为CommonErrorHandler，并调整实现逻辑：

   • 原ErrorHandler的handle(Exception thrownException, ConsumerRecord<?, ?> data)方法，对应CommonErrorHandler的handleRecord(Exception exception, ConsumerRecord<?, ?> record, Consumer<?, ?> consumer, MessageListenerContainer container)方法
   • 自定义错误处理器需实现CommonErrorHandler接口，而非旧的ErrorHandler

3. 验证构建
   重新执行Maven构建命令确认问题修复：

   mvn clean install
   

补充说明 #

Spring Boot 3.2.x在错误处理方面的兼容性变更，本质是对齐Spring Kafka 3.2.x的API调整——旧的ErrorHandler、BatchErrorHandler等接口被统一替换为CommonErrorHandler，以提供更一致的错误处理模型。

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