You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

WildFly23迁移至WildFly30后Spring Boot API报404及类定义失败求助

问题排查与解决方案

核心原因:WildFly 30基于Jakarta EE 11,所有原Java EE API已从javax.*迁移至jakarta.*命名空间。你的Spring Boot应用若仍依赖旧的javax.servlet相关API,会导致类加载失败,进而Spring MVC组件初始化异常,最终引发接口404。

以下是具体解决步骤:

1. 升级Spring Boot至兼容Jakarta EE的版本

Spring Boot 3.x系列开始全面适配Jakarta API,需将spring-boot-starter-parent升级到3.2.x及以上版本(对应Jakarta EE 11):

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.5</version> <!-- 可替换为最新稳定版 -->
    <relativePath/>
</parent>

2. 匹配Java版本要求

Spring Boot 3.x与Jakarta EE 11均要求Java 17及以上,修改pom.xml中的Java版本配置:

<properties>
    <java.version>17</java.version>
</properties>

3. 替换旧的Java EE依赖为Jakarta版本

  • 移除所有直接引入的javax.*命名空间的Servlet/JSP相关依赖(如javax.servlet:javax.servlet-api)。
  • 若需显式依赖,使用Jakarta命名空间的依赖,例如:
<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
    <version>6.0.0</version> <!-- 适配Jakarta EE 11 -->
    <scope>provided</scope>
</dependency>

4. 调整Web容器依赖配置

确保Spring Boot的内嵌Tomcat依赖被标记为provided(WildFly 30自带Web容器):

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

5. 清理缓存并重新部署

  • 删除WildFly安装目录下standalone/data/content的缓存文件,避免旧类残留。
  • 执行mvn clean package重新打包项目,确保所有依赖均为Jakarta兼容版本,再重新部署到WildFly 30。

内容的提问来源于stack exchange,提问作者Николай Бывальцев

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.04 10:40:04