如何在特定Spring Profile下禁用Spring Kafka模块？

要在特定Profile（比如开发环境dev）下完全禁用Spring-Kafka，避免不必要的Kafka连接尝试，你可以试试这几种实用方案：

方案1：排除Kafka自动配置类 #

Spring Boot的自动配置会默认加载Kafka相关组件，你可以在目标Profile的配置文件里直接排除Kafka的自动配置类，彻底阻止Kafka模块初始化：

# application-dev.yml
spring:
  autoconfigure:
    exclude:
      - org.springframework.boot.autoconfigure.kafka.KafkaAutoConfiguration

这个方法最直接，会让Spring Boot完全不加载任何Kafka相关的自动配置Bean，适合完全不需要Kafka的环境。

方案2：用@Profile注解控制自定义Kafka配置 #

如果你的项目里有自定义的Kafka配置类（比如自己写的生产者、消费者配置），可以给这些配置类加上@Profile注解，指定它们只在非目标Profile下生效：

@Configuration
@Profile("!dev") // 除dev环境外，其他Profile都会加载这个配置
public class CustomKafkaConfig {
    // 你的Kafka生产者工厂、消费者工厂、监听容器等配置代码
}

这样dev环境启动时，Spring就不会加载这个配置类里的所有Kafka相关Bean。

方案3：自定义开关配置（模拟spring.kafka.enabled） #

如果你想要类似spring.kafka.enabled: false的直观配置，可以结合@ConditionalOnProperty注解实现自定义开关：

1. 先给你的Kafka配置类加上条件注解：

@Configuration
@ConditionalOnProperty(
    name = "spring.kafka.enabled",
    havingValue = "true",
    matchIfMissing = true // 默认开启，只有显式设为false时才禁用
)
public class CustomKafkaConfig {
    // Kafka相关配置
}

2. 然后在目标Profile的配置文件里添加开关：

# application-dev.yml
spring:
  kafka:
    enabled: false

这种方式更灵活，你可以在任意Profile里通过这个开关快速启用/禁用Kafka模块。

补充：仅禁用消费者监听（不完全关闭模块） #

如果只是不想启动Kafka消费者监听，但还需要保留生产者功能，可以单独关闭监听容器的自动启动：

# application-dev.yml
spring:
  kafka:
    listener:
      auto-startup: false

这个配置会让所有@KafkaListener注解的方法不会自动启动监听，但Kafka的生产者和相关配置依然会正常加载。

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