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

Eclipse STS中WildFly 27目标运行时禁用及部署报错求助

Tomcat 9 迁移 WildFly 27 问题解决方案

一、激活并选择WildFly 27.0 Runtime

要解决Project Facets和Targeted Runtimes中WildFly Runtime禁用的问题,按以下步骤操作:

  • 打开项目属性 → 进入Project Facets页面
    1. 先取消勾选当前的Dynamic Web Module(通常是4.0版本,对应Tomcat 9),点击「应用」
    2. 重新勾选Dynamic Web Module,并选择6.0版本(WildFly 27基于Jakarta EE 10,对应Servlet 6.0)
    3. 切换到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,解决步骤如下:

  1. 升级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>
      
  2. 替换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>
      
  3. 检查第三方依赖兼容性:
    • 升级MyBatis、Hibernate等库到支持Jakarta EE的版本(如Hibernate 6.x、MyBatis 3.5.13+)
  4. 清理重建项目:
    • 执行mvn clean install(Maven)或gradle clean build(Gradle),清理旧依赖后重新构建war包

内容的提问来源于stack exchange,提问作者Thara

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.04 08:55:22