Spring Boot 3.0+Tomcat10.1部署HTML页面出现404错误求助

环境信息 #

• Spring Boot 3.0
• Tomcat 10.1
• Java 19
• 页面为HTML格式

问题现象 #

项目部署到Tomcat后，浏览器访问出现HTTP Status 404错误，页面无法找到。
Controller代码已调整过，以下是项目的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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.0</version>
        <relativePath /> <!-- lookup parent from repository -->
    </parent>
    <groupId>br.com.schmersal.tabela</groupId>
    <artifactId>tabeladinamica</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>tabeladinamica</name>
    <description>Template de tabela de dados</description>
    <properties>
        <java.version>19</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-devtools</artifactId>
            <scope>runtime</scope>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-cache</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-mongodb</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>com.microsoft.sqlserver</groupId>
            <artifactId>mssql-jdbc</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-rest</artifactId>
        </dependency>
    </dependencies>

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

已检查Spring Boot配置属性和偏好设置，仍未解决问题，请教还有哪些可能遗漏的配置？

排查方向 #

1. 部署路径与访问URL匹配 #

• 确认Tomcatwebapps目录下的war包名称，访问URL需要加上war包名称（除非设置为ROOT路径）。例如war包名为tabeladinamica-0.0.1-SNAPSHOT.war，访问路径应为http://localhost:8080/tabeladinamica-0.0.1-SNAPSHOT/[Controller映射路径]
• 若需根路径访问，可将war包重命名为ROOT.war，或在Tomcat的server.xml中配置Context指定路径。

2. 配置Spring Boot Servlet初始化类 #

Spring Boot 3.x部署到外部Tomcat必须继承SpringBootServletInitializer并覆盖configure方法，确保Tomcat能正确加载Spring上下文：

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

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

3. Thymeleaf模板路径校验 #

项目引入了Thymeleaf依赖，需确认：

• HTML页面默认存放路径为src/main/resources/templates，若自定义路径，需在application.properties中配置：

  spring.thymeleaf.prefix=classpath:/自定义目录/
  

• Controller返回的视图名称需与HTML文件名完全一致（无需加.html后缀）。

4. 兼容性检查 #

Tomcat 10.x使用Jakarta EE规范，Spring Boot 3.x已适配，但需确认：

• 项目中无遗留的javax.*包依赖，所有相关API需替换为jakarta.*（Spring Boot 3.x自动处理，但需检查自定义依赖是否兼容）。

5. 日志排查 #

查看Tomcat的logs/catalina.out或项目日志，检查是否存在Controller初始化失败、Bean加载异常等信息，这些问题会导致请求无法映射到处理方法。

6. Maven打包配置确认 #

• 确保spring-boot-maven-plugin包含repackage目标，保证生成可部署的war包：

  <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <executions>
          <execution>
              <goals>
                  <goal>repackage</goal>
              </goals>
          </execution>
      </executions>
  </plugin>
  

• 执行mvn clean package打包，检查war包内WEB-INF/classes目录是否包含templates文件夹和配置文件。

内容的提问来源于stack exchange，提问作者Camila Cavallante