Spring Boot配置War包后IDE无法运行，寻求无需切换配置的解决方案

核心思路 #

问题根源在于spring-boot-starter-tomcat的provided作用域：IDE运行时需要该依赖加载Servlet相关类，但打包War时需排除它，让外部Tomcat提供。通过Maven/Gradle的环境区分配置，可实现无需手动修改就能兼容两种场景。

Maven配置方案 #

在pom.xml中做如下调整：

1. 保持打包方式为war：

<packaging>war</packaging>

2. 给spring-boot-starter-tomcat配置双作用域，通过profile自动切换：

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-tomcat</artifactId>
        <scope>provided</scope>
    </dependency>
</dependencies>

<profiles>
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
                <scope>compile</scope>
            </dependency>
        </dependencies>
    </profile>
</profiles>

• IDE运行时，默认激活dev profile，spring-boot-starter-tomcat以compile作用域加载，解决类找不到的问题。
• 打包War时，执行命令mvn clean package -P!dev关闭dev profile，依赖自动回到provided作用域，生成适配外部Tomcat的War包。

Gradle配置方案 #

在build.gradle中配置：

plugins {
    id 'org.springframework.boot' version '你的Spring Boot版本'
    id 'war'
}

war {
    enabled = true
}

dependencies {
    // 打包时标记为外部Tomcat提供
    providedRuntime 'org.springframework.boot:spring-boot-starter-tomcat'
    // 开发环境自动引入该依赖
    developmentOnly 'org.springframework.boot:spring-boot-starter-tomcat'
}

// 让IDE识别developmentOnly依赖到运行环境
configurations {
    developmentOnly
    runtimeClasspath.extendsFrom developmentOnly
}

• developmentOnly依赖仅在IDE运行时生效，自动加载Servlet相关类。
• 打包War时，providedRuntime会排除该依赖，生成符合外部Tomcat要求的包。

主类配置保持不变 #

主类依然继承SpringBootServletInitializer，无需修改：

@SpringBootApplication
public class YourApplication extends SpringBootServletInitializer {
    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
        return application.sources(YourApplication.class);
    }

    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

完成以上配置后，IDE中直接运行主类即可正常启动项目，打包时执行对应命令就能生成适配外部Tomcat的War包，无需反复修改配置。

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