WAR文件放置正确webapps目录时Tomcat访问仍报404错误

• 作为Maven及Java项目构建初学者，使用Maven完成Java项目构建后，将命名为print的WAR文件复制到Tomcat的webapps目录，目录路径为：/opt/homebrew/Cellar/tomcat/10.0.22/libexec/webapps
• 访问地址http://localhost:8080/print/时，页面返回 HTTP Status 404 – Not Found 错误
• 已确认该应用路径在Tomcat Web Application Manager中正常展示：
  
• 参考多个相关问题的解决指南尝试修复均未生效，无法定位问题根源。
• 项目pom.xml文件内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.springhow.example</groupId>
  <artifactId>hello-world</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>war</packaging>

  <name>hello-world</name>
  <description>Demo project for Spring Boot</description>

  <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.3.2.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
  </parent>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
  </properties>

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

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

三个核心问题导致404：

1. 版本不兼容：Tomcat 10.x及以上版本将Java EE的包命名空间从javax.*全量迁移到jakarta.*，当前使用的Spring Boot 2.3.2.RELEASE基于javax.servlet体系开发，和Tomcat 10完全不兼容。此时Tomcat仅识别到WAR包做了基础解压，应用实际未启动成功，因此管理器中能看到路径，但所有请求都找不到对应映射。
2. 缺少外部Tomcat启动配置：Spring Boot项目部署到外部Tomcat时，启动类必须继承SpringBootServletInitializer并重写引导方法，否则Tomcat无法初始化Spring上下文。
3. 包名与配置不匹配：当前pom未指定构建产物名称，Maven默认输出的WAR包名为hello-world-0.0.1-SNAPSHOT.war，手动重命名为print.war时如果Tomcat未完全停止，容易出现解压目录和WAR包版本不一致的问题。

按顺序操作即可解决：

1. 解决版本兼容问题，二选一：
   • 方案1（改动最小，适配当前JDK1.8配置）：卸载Tomcat 10，安装Tomcat 9.x版本。Tomcat 9是支持javax.servlet体系的稳定版，和Spring Boot 2.x完全兼容。
   • 方案2（保留Tomcat 10）：将Spring Boot版本升级到3.0.0及以上，同步将JDK版本升级到17及以上，Spring Boot 3原生适配jakarta.servlet命名空间。
2. 修改项目启动类，继承SpringBootServletInitializer，示例代码如下：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;

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

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

3. 在pom.xml的<build>节点下添加<finalName>print</finalName>配置，构建时直接生成print.war，无需手动重命名，配置示例：

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

4. 清理Tomcat残留缓存后重新部署：
   • 停止Tomcat服务
   • 删除webapps目录下的print.war包、已解压的print文件夹
   • 删除Tomcat的work/Catalina/localhost目录下所有和print相关的缓存文件
   • 执行mvn clean package重新构建项目，将target目录下新生成的print.war复制到webapps目录
   • 启动Tomcat，等待WAR包自动解压完成后再访问

启动后先查看Tomcat日志目录下的catalina.out文件，确认没有Spring启动报错，再访问http://localhost:8080/print/。如果项目没有编写根路径的接口，可以先加一个测试Controller验证：

@RestController
public class TestController {
    @GetMapping("/")
    public String test() {
        return "deploy success";
    }
}

内容的提问来源于stack exchange，提问作者Michelle Crown