Eclipse STS中WildFly 27目标运行时禁用及部署报错求助
Tomcat 9 迁移 WildFly 27 问题解决方案
一、激活并选择WildFly 27.0 Runtime
要解决Project Facets和Targeted Runtimes中WildFly Runtime禁用的问题,按以下步骤操作:
- 打开项目属性 → 进入
Project Facets页面- 先取消勾选当前的
Dynamic Web Module(通常是4.0版本,对应Tomcat 9),点击「应用」 - 重新勾选
Dynamic Web Module,并选择6.0版本(WildFly 27基于Jakarta EE 10,对应Servlet 6.0) - 切换到
Runtimes标签页,此时WildFly 27.0 Runtime会变为可选状态,勾选后点击「应用」「确定」
- 先取消勾选当前的
- 再进入项目属性 →
Targeted Runtimes页面,取消勾选Tomcat Runtime,即可勾选WildFly 27.0 Runtime,保存配置
二、需要调整/卸载的Facets
核心是让Facets版本匹配WildFly 27的Jakarta EE 10规范:
- 必须调整:旧版本的
Dynamic Web Module(如4.0/5.0),先卸载旧版本,再添加6.0版本 - 按需调整:如果项目包含
JavaServer Faces、EJB等Facets,需卸载旧版本(如JSF 2.3、EJB 3.2),替换为符合Jakarta EE 10的版本(JSF 4.0、EJB 4.0) - 注意:不要强行勾选WildFly Runtime,必须先把所有Facets调整到兼容版本,否则会保持禁用状态
三、解决DispatcherServlet不实现jakarta.servlet.Servlet报错
这个错误的本质是项目依赖的Spring框架仍基于旧的javax.servlet API,而WildFly 27使用的是Jakarta EE 10的jakarta.servlet API,解决步骤如下:
- 升级Spring到支持Jakarta EE的版本:
- 若使用Spring MVC,需升级到Spring 6.x;若为Spring Boot项目,需升级到Spring Boot 3.x
- Maven依赖示例:
<dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>6.0.11</version> <!-- 或更高6.x版本 --> </dependency>
- 替换Servlet API依赖:
- 移除旧的
javax.servlet-api,替换为Jakarta版本:<dependency> <groupId>jakarta.servlet</groupId> <artifactId>jakarta.servlet-api</artifactId> <version>6.0.0</version> <scope>provided</scope> <!-- WildFly已内置该API,无需打包进war --> </dependency>
- 移除旧的
- 检查第三方依赖兼容性:
- 升级MyBatis、Hibernate等库到支持Jakarta EE的版本(如Hibernate 6.x、MyBatis 3.5.13+)
- 清理重建项目:
- 执行
mvn clean install(Maven)或gradle clean build(Gradle),清理旧依赖后重新构建war包
- 执行
内容的提问来源于stack exchange,提问作者Thara
相关产品推荐
相关产品推荐

