Gradle环境下org.springframework.kafka无法解析，找不到KafkaListener类

环境信息 #

• 操作系统：Windows
• Spring Boot版本：2.7.9
• Spring版本：5.3.25
• Java版本：11

相关代码与配置 #

KafkaController.java 代码片段 #

import org.springframework.kafka.annotation.KafkaListener;
...

@KafkaListener(topics = topicName, groupId = groupId)
public void listen(String message) {

...

}

build.gradle 配置片段 #

// kafka
implementation 'org.apache.kafka:kafka-clients:3.0.0'

已执行gradlew clean build操作，但问题仍存在。

解决方案 #

@KafkaListener是Spring Kafka框架提供的注解，并非kafka-clients原生依赖的内容，仅引入kafka-clients不足以支持该注解的使用。

针对Spring Boot项目，直接添加Spring Kafka的starter依赖即可，它会自动适配Spring Boot版本并管理相关依赖：

implementation 'org.springframework.boot:spring-boot-starter-kafka'

替换原有的kafka-clients依赖（starter已包含兼容版本的kafka-clients），重新执行gradlew clean build后启动项目即可解决问题。

之前项目能正常运行，大概率是因为其他依赖间接引入了Spring Kafka，后续依赖变更导致该依赖被移除，从而触发了当前的类找不到错误。

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