本文介绍如何使用 Spring Kafka 的 @KafkaListener 注解，结合 SpEL 表达式从 application.yml 或 application.properties 中读取逗号分隔的多个主题名，并实现动态多主题监听。

本文介绍如何使用 spring kafka 的 `@kafkalistener` 注解，结合 spel 表达式从 application.yml 或 application.properties 中读取逗号分隔的多个主题名，并实现动态多主题监听。

在 Spring Kafka 中，@KafkaListener 的 topics 属性支持 SpEL（Spring Expression Language）表达式，这使得我们可以灵活地从外部配置中解析并注入多个主题。直接使用 ${application.kafka.topics} 会导致整个字符串（如 "topic1, topic2"）被当作单个主题名处理，从而引发订阅失败或运行时异常。正确做法是利用 SpEL 的 split() 方法将配置字符串转换为 String[] 数组。

✅ 正确配置方式如下：

application.yml：

kafka:
  topics: topic1,topic2,topic3

Java 监听器代码：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

@KafkaListener(topics = "#{'${kafka.topics}'.split(',')}")
public void listen(ConsumerRecord<?, ?> record, Acknowledgment ack) {
    System.out.println("Received: " + record.topic() + " -> " + record.value());
    ack.acknowledge();
}

⚠️ 注意事项：

• split(',') 返回的是 String[]，完全符合 @KafkaListener.topics 所需类型（String...），无需额外转换；
• 配置值中避免首尾空格（如 topic1, topic2），否则会创建带空格的主题名（如 " topic2"），导致订阅无效；如需兼容空格，可改用 #{'${kafka.topics}'.trim().split('\s*,\s*')}；
• 若主题列表为空或配置未定义，SpEL 会抛出 IllegalArgumentException，建议配合 @Value 默认值或配置校验保障健壮性，例如：

  kafka:
    topics: "${KAFKA_TOPICS:default-topic}"

? 进阶提示：若需按主题做差异化处理，可结合 @Header(KafkaHeaders.RECEIVED_TOPIC) 获取当前消息所属主题，或使用 @KafkaListener(topicPattern = "topic-.*") 实现正则匹配订阅。

综上，通过 SpEL 动态解析配置项，既能保持配置与代码分离，又可安全、简洁地实现多主题监听，是 Spring Kafka 生产环境推荐的最佳实践之一。