Spring Boot如何基于Profile控制Tomcat启停与Kafka Consumer加载

问题根源 #

你的项目依赖里包含了spring-boot-starter-web，这个依赖会触发Spring Boot的嵌入式Web服务器自动配置逻辑——不管你用哪个Profile，只要这个依赖存在，Tomcat就会被尝试启动。所以要在Kafka Profile下禁用Tomcat，核心就是切断Web相关的自动配置。

三种可行方案 #

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

修改KafkaScanConfiguration，添加Web相关的自动配置排除项：

@Configuration
@EnableAutoConfiguration(
        exclude = {
                DataSourceAutoConfiguration.class,
                HibernateJpaAutoConfiguration.class,
                ElasticsearchDataAutoConfiguration.class,
                ServletWebServerFactoryAutoConfiguration.class, // 阻止嵌入式Web服务器初始化
                WebMvcAutoConfiguration.class // 禁用Spring MVC相关配置
        })
@ComponentScan(basePackages = {"package.app.kafka"})
@Profile("kafka")
public class KafkaScanConfiguration {
}

方案2：通过配置文件指定非Web环境 #

创建application-kafka.properties（或yaml格式），添加一行配置强制应用以非Web模式启动：

spring.main.web-application-type=NONE

这个方法最简单，不需要改代码，只需要添加配置文件即可生效，优先推荐。

方案3：按Profile控制Web依赖的引入 #

如果Kafka环境完全不需要Web相关功能，可以在pom.xml里用Profile控制spring-boot-starter-web的依赖范围：

<dependencies>
    <!-- 其他依赖保持不变 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <scope>${web.dependency.scope}</scope>
    </dependency>
</dependencies>

<profiles>
    <profile>
        <id>default</id>
        <properties>
            <web.dependency.scope>compile</web.dependency.scope>
        </properties>
    </profile>
    <profile>
        <id>kafka</id>
        <properties>
            <web.dependency.scope>provided</web.dependency.scope>
        </properties>
    </profile>
</profiles>

这样在kafka Profile下，Web依赖不会被打包进应用，自然不会触发Tomcat的启动逻辑。

额外注意 #

如果你的项目用到了Actuator，在非Web环境下Actuator的HTTP端点会无法访问。如果Kafka环境不需要Actuator，可以考虑在Kafka配置类中排除ActuatorAutoConfiguration，或者直接在kafka配置文件里禁用Actuator：

management.endpoints.enabled-by-default=false

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