Spring Kafka启动报错CommonErrorHandler类型不存在如何解决

该异常本质是Spring Kafka依赖与Spring Boot版本不兼容导致的类缺失问题。
报错中提示找不到的org.springframework.kafka.listener.CommonErrorHandler是Spring Kafka 2.8及以上版本才引入的类。从异常栈信息可确认当前项目使用的Spring Beans版本为5.3.21，对应Spring Boot 2.7.x版本，该版本内置的Kafka自动配置类KafkaAnnotationDrivenConfiguration初始化时会加载CommonErrorHandler相关逻辑，但项目实际引入的Spring Kafka版本低于2.8，类路径下不存在对应类，触发TypeNotPresentException，最终导致Bean创建失败、应用启动报错。
这类问题通常是手动指定了过低的Spring Kafka版本，覆盖了Spring Boot官方依赖管理默认的兼容版本导致的。

根据项目情况选择对应方案即可：

• 方案一（推荐）：删除构建文件（pom.xml/build.gradle）中spring-kafka依赖的手动版本声明，直接使用Spring Boot官方BOM管理的适配版本，无需手动做版本对齐。Maven依赖写法参考：

<dependency>
    <groupId>org.springframework.kafka</groupId>
    <artifactId>spring-kafka</artifactId>
</dependency>

• 方案二：如果有特殊需求必须手动指定Spring Kafka版本，将版本升级到与当前Spring Boot匹配的区间即可。例如Spring Boot 2.7.x对应兼容的Spring Kafka版本为2.8.x及以上，禁止使用2.7及更早版本。

修改依赖配置后，刷新Maven/Gradle依赖，清理本地缓存的旧版本依赖包，重启应用即可恢复正常。

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