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

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

🔍 核心原因排查点

启动类未正确配置：
- 问题： 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：
复制代码
```
<packaging>war</packaging>
```

排除内嵌Tomcat依赖并将其标记为provided：

复制代码

<dependencies>
    <!-- 其他依赖... -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <!-- 排除内嵌Tomcat -->
        <exclusions>
            <exclusion>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-tomcat</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <!-- 添加Tomcat依赖，scope为provided，表示由外部Tomcat提供 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-tomcat</artifactId>
        <scope>provided</scope> <!-- 关键！ -->
    </dependency>
    <!-- 其他依赖... -->
</dependencies>

使用Spring Boot的War插件（可选但推荐）：

复制代码

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

上下文路径（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文件（文件名决定上下文路径），内容为：
        
        复制代码
        
        <Context docBase="/path/to/your/war/your-war-name.war" />
      - 使用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。

📖 关键点回顾

启动类必须继承 SpringBootServletInitializer。
**pom.xml必须正确配置为 war打包并处理内嵌Tomcat依赖（标记为 provided）。**
外部Tomcat部署后应用会有上下文路径（Context Path），不再是根路径 /。
Tomcat日志 (catalina.out, localhost_*.log) 是诊断问题的黄金标准，务必仔细查看！

按照这些步骤逐一排查，基本能解决Spring Boot WAR包部署到Tomcat后无法访问的问题。💪