<think>好的，我现在需要解决用户的问题：将Spring Boot
项目打
包成
WAR部署到
Tomcat后出现
404错误。首先，我得回忆一下Spring Boot的打
包部署流程和相关配置。
用户提到的是
404错误，这意味着应用
部署成功，但访问的资源不存在。可能的原因有几个方面：
1. **
项目结构问题**：标准的
WAR包结构是否完整，比如WEB-INF目录的位置是否正确。
2. **Servlet初始化配置**：Spring Boot需要初始化Servlet上下文，通常通过继承`
SpringBootServletInitializer`并重写`configure`方法。
3. **依赖冲突**：可能
Tomcat服务器自带的库与
项目中的嵌入式
Tomcat依赖冲突，导致应用没有正确启动。
4. **上下文路径配置**：应用在
Tomcat中的上下文路径可能与预期不同，导致访问路径错误。
5. **打
包配置错误**：pom.xml中可能没有正确设置打
包类型为
war，或者没有排除嵌入式容器。
接下来，我需要逐步检查这些可能性。首先，确认
项目结构是否正确，特别是WEB-INF目录的位置。然后检查启动类是否继承了`
SpringBootServletInitializer`，如果没有的话，应用可能无法正确初始化。接着，查看pom.xml文件，确保打
包方式改为
war，并且排除了嵌入式
Tomcat依赖。同时，检查
部署后的
Tomcat日志，看看是否有启动时的异常信息，比如Bean加载失败或者上下文初始化错误，这些都会导致应用无法正常启动，从而返回
404。
另外，上下文路径的问题也很重要。Spring Boot默认的上下文路径是根路径，但
部署到
Tomcat后，应用可能会被
部署到以
项目名命名的路径下，比如http://localhost:8080/myapp/。如果应用内部的控制器路径没有调整，或者静态资源路径配置不当，也可能导致
404。用户需要确认访问的URL是否正确，是否
包含了正确的上下文路径。
还有可能，应用虽然
部署成功，但某些配置错误导致控制器没有正确注册，或者静态资源未被正确映射。这时候需要检查控制器的@RequestMapping注解是否正确，以及静态资源的位置是否符合
Tomcat的要求。
总结一下，解决步骤应该是：检查
项目结构、确保启动类正确配置、调整pom.xml排除嵌入式
Tomcat、检查
Tomcat日志定位问题、验证上下文路径和访问URL是否正确。如果这些步骤都正确，可能需要进一步深入分析日志或代码中的其他配置问题。</think>将Spring Boot
项目打
包为
WAR部署到
Tomcat后出现
404错误，通常由以下原因导致。请按以下步骤排查：
---
### 一、基础配置检查
1. **修改打
包方式**
在`pom.xml`中设置打
包类型为`
war`：
```xml
<packaging>
war</packaging>
```
2. **排除嵌入式
Tomcat**
添加依赖排除：
```xml
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-
tomcat</artifactId>
<scope>provided</scope> <!-- 关键：由外部
Tomcat提供 -->
</dependency>
```
3. **继承`
SpringBootServletInitializer`**
修改启动类，重写`configure`方法：
```java
@
SpringBootApplication
public class Application extends
SpringBootServletInitializer {
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
return builder.sources(Application.class);
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
```
---
### 二、
部署路径问题
1. **检查
Tomcat上下文路径**
WAR包部署后，默认访问路径为`http://localhost:8080/
项目名/`。
*若需要根路径访问*，在`application.properties`中添加：
```properties
server.servlet.context-path=/
```
但需在
Tomcat的`server.xml`中配置`<Context path="" docBase="
项目名"/>`。
2. **验证控制器路径**
确保Controller的`@RequestMapping`路径正确，例如：
```java
@RestController
public class DemoController {
@GetMapping("/test")
public String test() {
return "OK";
}
}
```
访问URL应为：`http://localhost:8080/
项目名/test`
---
### 三、日志排查
1. **检查
Tomcat启动日志**
查看`catalina.out`或`localhost.log`，确认：
- 应用是否成功启动（搜索`Application started`）
- 是否有Bean加载失败或异常
2. **查看Spring Boot日志**
在`application.properties`中开启调试日志：
```properties
logging.level.root=DEBUG
```
---
### 四、其他常见问题
1. **文件路径大小写敏感**
Linux环境下
Tomcat对路径大小写敏感，确保URL与代码中路径完全匹配。
2. **静态资源未加载**
静态资源需放在`src/main/webapp`目录（非`resources/static`），或配置：
```properties
spring.web.resources.static-locations=classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/,/webapp/
```
---
### 五、完整解决方案流程图
```plaintext
修改pom.xml → 排除嵌入式
Tomcat → 继承
SpringBootServletInitializer → 检查
部署路径 → 查看
Tomcat日志 → 验证URL
```
---
通过以上步骤，可解决大部分
404问题。如果仍无法解决，建议提供
Tomcat日志中的具体错误信息进一步分析。
本文指导新手如何正确部署项目并解决访问路径问题，详细解释了如何修改war包名称及项目名，确保项目能通过自定义的URL进行访问。
扫一扫
2600
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
