在JBoss EAP 7.4.0部署Spring Boot 3.1.2应用时遇NoClassDefFoundError

根本原因 #

Spring Boot 3.x 全面基于 Jakarta EE 9+ 规范，所有Java EE API包名已从javax.*迁移到jakarta.*；但JBoss EAP 7.4.0是基于Java EE 8的，仅支持javax.*命名空间的API。两者的API命名空间完全不兼容，导致Spring Boot 3的org.springframework.web.servlet.tags.form相关类找不到依赖的jakarta.servlet.jsp.tagext.DynamicAttributes类。

可行解决方案 #

1. 降级Spring Boot到2.x系列（推荐，稳定适配） #

JBoss EAP 7.4.0对Spring Boot 2.x（基于Java EE 8）有良好支持，具体操作：

• 修改pom.xml中的spring-boot-starter-parent版本为2.7.x LTS（比如2.7.14，Spring Boot 2的最后一个稳定LTS版本）：

  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>2.7.14</version>
      <relativePath/> <!-- lookup parent from repository -->
  </parent>
  

• 同步调整项目中所有Spring相关依赖的版本，确保与父版本一致，避免依赖冲突。
• 将JSP/JSTL依赖的scope设置为provided，因为JBoss EAP自带这些API，避免重复打包引发冲突：

  <dependency>
      <groupId>javax.servlet.jsp</groupId>
      <artifactId>javax.servlet.jsp-api</artifactId>
      <scope>provided</scope>
  </dependency>
  <dependency>
      <groupId>javax.servlet.jsp.jstl</groupId>
      <artifactId>jstl-api</artifactId>
      <scope>provided</scope>
  </dependency>
  

2. 升级JBoss EAP到支持Jakarta EE 9+的版本 #

如果必须保留Spring Boot 3.x，需将JBoss EAP升级到8.x版本（EAP 8.0及以上全面支持Jakarta EE 9.1），升级后可直接部署Spring Boot 3的WAR包，无需额外调整依赖命名空间。

3. 临时兼容方案（不推荐，风险高） #

尝试通过jboss-deployment-structure.xml排除JBoss自带的javax.servlet相关依赖，并打包Jakarta EE 9的API到WAR中，但这种方式会引发大量潜在兼容性问题（比如JBoss容器与应用内API的冲突），仅建议作为临时测试使用，不适合生产环境。

内容的提问来源于stack exchange，提问作者Maftun Hashimli