<think>好的，我现在需要解决用户提出的Spring Boot项目打
包成
war后部署到Tomcat启动成功但访问404的问题。首先，我得回忆一下相关的知识，同时结合用户提供的引用内容来分析可能的原因和解决方案。
用户已经给出了一些引用，其中提到了几个关键点：
1. 需要将内嵌的Tomcat依赖设置为provided，这样打
包的时候就不会
包含它，避免冲突。[^2]
2. 需要继承
SpringBootServletInitializer并配置入口类，这样外部Tomcat才能正确启动应用。[^3][^5]
3. 检查Tomcat版本是否与Spring Boot内置版本一致，否则可能不兼容导致404。[^4]
4. 访问路径是否正确，可能应用的上下文路径或URL拼写错误。[^1]
首先，我应该按照步骤梳理解决方案。第一步是确认依赖是否正确。根据引用[2]，用户需要修改pom.xml，将内嵌Tomcat的scope设为provided。这确保打
包时排除内嵌容器，避免与外部Tomcat冲突。如果这一步没做，可能会导致类冲突或资源加载问题，从而404。
第二步是检查入口类是否正确配置。引用[3]和[5]提到需要继承
SpringBootServletInitializer，并重写configure方法，指定启动类。用户可能没有正确配置这个入口类，或者启动类没有正确指向主应用类。例如，可能需要创建一个新的类继承
SpringBootServletInitializer，或者在原有的主类中扩展，并覆盖configure方法。如果这里配置错误，外部Tomcat可能无法正确初始化Spring Boot应用，导致应用没有正确部署，进而404。
第三步是Tomcat版本兼容性问题。引用[4]提到需要确保Tomcat版本与Spring Boot内置的版本一致。比如，如果Spring Boot 1.5.1使用的是Tomcat 8.x，而用户部署到Tomcat 7，就可能出现兼容性问题。用户需要检查对应版本，并在Tomcat中使用匹配的版本。这可能涉及到升级Tomcat或者调整Spring Boot版本。
第四步是检查访问路径。Spring Boot应用部署到Tomcat后，默认的上下文路径是
war包的名字。例如，如果
war包名为app.
war，那么访问路径应该是http://localhost:8080/app/。如果用户没有正确添加上下文路径，直接访问根路径，就会导致404。此外，应用的Controller是否有正确的请求映射也需要检查，比如是否有@RequestMapping注解，或者是否配置了server.servlet.context-path，这在外部部署时可能被覆盖。
其他可能的因素
包括打
包过程中资源文件未正确
包含，比如静态资源或模板文件没有被打
包进
war，导致无法找到资源。这时候需要检查构建配置，确保src/main/webapp目录存在且资源正确。此外，Tomcat的日志中可能
包含更详细的错误信息，查看catalina.out或localhost日志可以帮助定位问题。
根据用户的引用，特别是引用[5]中提到的方法二，建议创建一个单独的
SpringBootStartApplication类来配置，这可能更灵活。用户需要确保入口类正确指向原来的主类。同时，部署后需要检查Tomcat的webapps目录下是否正确解压了
war包，生成对应的文件夹，并检查是否有启动错误。
总结可能的解决步骤：
1. 检查并修改pom.xml中的Tomcat依赖为provided。
2. 配置入口类继承
SpringBootServletInitializer。
3. 确保Tomcat版本与Spring Boot内置版本一致。
4. 检查访问路径是否
包含正确的上下文。
5. 查看Tomcat日志确认具体错误。
现在需要将这些步骤详细地组织成用户容易理解的解决方案，分点说明，并引用相关参考资料。同时，生成相关问题，帮助用户进一步排查类似问题。</think>### 解决Spring Boot
WAR包部署404问题的分步方案
#### 1. 排除内嵌Tomcat依赖
修改`pom.xml`，将内嵌Tomcat依赖的作用域设置为`provided`，确保打
包时不
包含内嵌容器：
```xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
```
否则可能导致与外部Tomcat冲突，引发类加载错误[^2]。
#### 2. 配置入口类继承`
SpringBootServletInitializer`
修改主启动类或新建独立类，继承`
SpringBootServletInitializer`并重写`configure`方法：
```java
@
SpringBootApplication
public class Application extends
SpringBootServletInitializer {
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
return builder.sources(Application.class);
}
}
```
此配置使外部Tomcat能正确初始化Spring Boot应用[^3]。
#### 3. 检查Tomcat版本兼容性
通过以下步骤查看Spring Boot内置Tomcat版本：
1. 打开本地Maven仓库中对应版本的`spring-boot-dependencies-x.x.x.RELEASE.pom`文件。
2. 搜索`<tomcat.version>`标签，确认版本号。
例如，Spring Boot 1.5.1对应Tomcat 8.5.x。
需确保部署的Tomcat版本与之匹配，否则升级Tomcat或调整Spring Boot版本。
#### 4. 验证访问路径
WAR包部署后，默认上下文路径为文件名（如`app.
war`对应路径`/app`）。
访问时应使用格式：`http://localhost:8080/app/your-endpoint`。
若需自定义上下文路径，可在`application.properties`中添加：
```properties
server.servlet.context-path=/myapp
```
但需注意：部分Tomcat版本可能覆盖此配置，建议直接重命名
WAR文件。
#### 5. 检查Tomcat日志
查看`logs/catalina.out`或`logs/localhost.log`，确认以下关键信息：
-
WAR包是否成功解压并部署。
- Spring Boot应用启动时是否有异常（如Bean加载失败）。
- 请求路径是否匹配Controller映射。
#### 6. 验证打
包内容
确保`src/main/webapp`目录存在且
包含静态资源（如HTML、JS）。
构建后检查
WAR包内容（使用`jar -tvf app.
war`命令），确认资源文件已
包含。
本文介绍如何将Spring Boot项目打包成WAR文件并部署到Tomcat服务器上，包括配置pom.xml、修改启动类、清理及安装项目、重命名并放置WAR文件，最后启动Tomcat访问应用。
扫一扫
8018
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
