当前位置：首页 > news >正文

springboot用jar启动能访问，但是打成war,部署到tomcat却访问不到 - 详解

news 2026/6/13 17:05:21

这个问题很常见，通常是由于Spring Boot应用在打包为WAR并部署到外部Tomcat时，配置或代码需要做一些特定的调整导致的。以下是详细的排查步骤和解决方案：

核心原因排查点

spring boot 配置java版本不能高于tomcat运行java版本：

启动类未正确配置：
- 问题： Spring Boot默认使用内嵌Tomcat启动（JAR方式）。当部署到外部Tomcat时，需要修改启动类。
- 解决： 确保你的主应用类（带@SpringBootApplication的类）继承SpringBootServletInitializer并重写configure方法。
- 示例代码：
```
@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); } }
```
- 作用： 这个方法告诉外部Tomcat如何启动你的Spring Boot应用。
pom.xml打包配置不正确：
- 问题： 打包类型未设置为war，或者内嵌容器依赖未正确排除/标记为provided。
- 解决：
  - 将<packaging>标签设置为war：
```
war
```
  - 排除内嵌Tomcat依赖并将其标记为provided：
```
org.springframework.boot spring-boot-starter-web org.springframework.boot spring-boot-starter-tomcat org.springframework.boot spring-boot-starter-tomcat provided
```
  - 使用Spring Boot的War插件（可选但推荐）：
```
org.springframework.boot spring-boot-maven-plugin
```
上下文路径（Context Path）问题：
- 问题： 在外部Tomcat中，你的应用会有一个上下文路径（Context Path），不再是JAR运行时的根路径/。
- 现象： 你可能在尝试访问http://localhost:8080/，但实际上应用部署在http://localhost:8080/your-war-name/。
- 解决：
  - 检查部署路径：
    - 查看Tomcat的webapps目录。你的应用通常部署在webapps/your-war-name目录（your-war-name是你的WAR文件名，不包含.war后缀）。
    - 查看Tomcat启动日志（catalina.out或localhost.yyyy-mm-dd.log），里面会明确记录应用部署的上下文路径。
    - 访问http://localhost:8080/manager/html（需要配置Tomcat用户权限）查看已部署应用列表及其上下文路径。
  - 配置应用上下文路径：
    - 在application.properties或application.yml中设置：
```
server.servlet.context-path=/myapp # 设置你想要的上下文路径
```
    - 或者，在部署时指定：
      - 将WAR文件重命名为ROOT.war部署到根上下文（访问http://localhost:8080/）。
      - 在Tomcat的conf/server.xml中配置<Context>元素（不推荐，影响可移植性）。
      - 在conf/Catalina/localhost/目录下创建一个your-war-name.xml文件（文件名决定上下文路径），内容为：
      - 使用Tomcat Manager应用部署时指定上下文路径。
资源加载问题：
- 问题： WAR包结构（包含WEB-INF目录）可能与JAR包结构不同，导致静态资源、模板文件或类路径资源加载失败。
- 解决：
  - 静态资源： 确保放在src/main/webapp目录下（这是WAR的标准静态资源目录）。Spring Boot默认也会从classpath:/static,classpath:/public等加载，但在WAR中相对路径可能不同。
  - 模板文件（Thymeleaf, Freemarker等）： 通常放在src/main/resources/templates下，一般问题不大，但检查模板引擎配置中是否有硬编码的绝对路径。
  - 检查日志： 查看是否有FileNotFoundException或类似资源加载错误。
部署或Tomcat配置问题：
- 问题： WAR包未正确部署，Tomcat配置有冲突，端口占用等。
- 解决：
  - 确认部署成功： 检查Tomcat日志，确保应用已成功部署且没有启动错误。查找类似INFO: Deployment of web application archive [/path/to/war] has finished in [ms]的消息。
  - 清理工作目录： 停止Tomcat，删除webapps目录下你的应用目录（如your-war-name）和work/Catalina/localhost/your-war-name目录，然后重新启动Tomcat。
  - 检查端口冲突： 确保Tomcat配置的端口（默认8080）没有被其他进程占用。
  - 检查Tomcat版本： 确保你使用的Tomcat版本与Spring Boot兼容（一般Spring Boot文档会说明支持的版本）。
  - 检查JDK版本： 确保构建WAR的JDK版本与运行Tomcat的JDK版本兼容。

排查步骤总结

检查启动类： 确认主类继承SpringBootServletInitializer并重写configure方法。
检查pom.xml：
- <packaging>war</packaging>
- 排除spring-boot-starter-tomcat并添加provided范围的依赖。
- 确保使用了spring-boot-maven-plugin。
检查上下文路径：
- 查看Tomcat日志确定实际部署路径。
- 尝试访问http://localhost:8080/your-war-name/（用你的WAR文件名替换your-war-name）。
- 在application.properties中设置server.servlet.context-path。
检查Tomcat日志： 这是最重要的！仔细阅读catalina.out和localhost.yyyy-mm-dd.log文件，查找部署过程、启动过程以及访问时的错误信息（如SEVERE或ERROR级别的日志）。日志通常会明确指出问题所在（如类找不到、Bean初始化失败、资源找不到、Servlet映射问题等）。
检查资源路径： 如果应用部分加载但资源（图片、CSS、JS）或API端点404，重点检查上下文路径和资源位置。
清理并重新部署： 停止Tomcat，删除webapps和work目录下的相关应用目录，重新部署WAR文件，再启动Tomcat。