Spring Boot 3.0.4部署Wildfly 24.0失败，求助解决

架构老林

2026-7-29

问题分析与解决方案

核心原因

Spring Boot 3.x基于Jakarta EE 9规范，将Servlet API的包名从javax.servlet彻底迁移到了jakarta.servlet；而Wildfly 24.x仍依赖旧版的javax.servlet API。你的项目中DispatcherServlet实现的是新的jakarta.servlet.Servlet接口，但Wildfly 24期望的是javax.servlet.Servlet，因此出现类不匹配的错误。

可行解决方案

方案1：降级Spring Boot到2.x版本（兼容Wildfly 24）

Spring Boot 2.x系列（如2.7.x LTS版本）仍使用javax.servlet API，完全兼容Wildfly 24。具体操作：

修改pom.xml中的Spring Boot父依赖版本：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.14</version> <!-- 选择2.x的LTS稳定版，支持Java 17 -->
    <relativePath/>
</parent>

确保所有Spring Boot相关依赖继承父版本，无需手动指定版本。
打包WAR时，将内置Tomcat依赖标记为provided（避免与Wildfly容器冲突）：

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

主类需继承SpringBootServletInitializer，确保WAR包能被Wildfly正确加载：

@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);
    }
}