升级Apache TomEE至9.1.3/10.0.0遇NoClassDefFoundError问题求助

问题背景 #

• 基于Maven的多模块Jakarta EE应用，当前在TomEE 9.0.0-M8上运行正常
• 尝试升级至TomEE 9.1.3或10.0.0时，服务器可启动但应用部署失败，抛出NoClassDefFoundError提示缺少Jakarta EE依赖
• 已完成所有javax.*到jakarta.*的包名替换
• 以WAR包形式部署在独立TomEE服务器，使用CDI进行依赖注入、JNDI管理数据库连接与资源

错误信息 #

核心类找不到错误 #

Caused by: java.lang.RuntimeException: java.lang.reflect.InvocationTargetException
    at org.apache.openejb.util.proxy.ClassDefiner.defineClassClassLoader(ClassDefiner.java:98)
    at org.apache.openejb.util.proxy.ClassDefiner.defineClass(ClassDefiner.java:83)
    at org.apache.webbeans.proxy.NormalScopeProxyFactory.createProxyClass(NormalScopeProxyFactory.java:264)
    at org.apache.webbeans.proxy.NormalScopeProxyFactory.createNormalScopeProxy(NormalScopeProxyFactory.java:149)
    at org.apache.webbeans.container.BeanManagerImpl.getReference(BeanManagerImpl.java:801)
    at org.apache.webbeans.portable.InjectionTargetImpl.injectFields(InjectionTargetImpl.java:234)
    ...
Caused by: java.lang.NoClassDefFoundError: org/apache/webbeans/proxy/OwbNormalScopeProxy
    at java.base/java.lang.ClassLoader.defineClass1(Native Method)
    at java.base/java.lang.ClassLoader.defineClass(ClassLoader.java:1017)
    ...
Caused by: java.lang.ClassNotFoundException: org.apache.webbeans.proxy.OwbNormalScopeProxy
    at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641)
    at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:525)

EJB初始化错误 #

jakarta.ejb.NoSuchEJBException: Singleton failed to initialize

已尝试操作及结果 #

• 直接从TomEE 9.0.0升级至9.1.3/10.0.0：服务器启动，但应用因org.apache.webbeans.proxy.OwbNormalScopeProxy的NoClassDefFoundError失败
• 更新pom.xml中Jakarta EE依赖以匹配目标TomEE版本：未解决问题，仍出现NoClassDefFoundError，部分JNDI资源无法正确解析
• 执行mvn clean install并更新tomee-maven-plugin清理重建：无改善，部署失败情况相同
• 对比不同TomEE版本的lib依赖，手动替换WebBeans库：未解决问题

问题解答 #

1. 从TomEE 9.0.0升级到9.1.3或10.0.0是否存在已知问题？ #

是的，TomEE 9.0.0-M8是早期里程碑版本，到9.1.3正式版之间存在不少依赖适配问题，尤其是OpenWebBeans内部API变更导致的类路径冲突。TomEE 10是基于Jakarta EE 10的重大版本，和TomEE 9的Jakarta EE 9规范存在兼容性边界，直接跨版本升级易出现依赖不匹配。

2. TomEE 9.0.0与9.1.3+之间的OpenEJB/OpenWebBeans是否有导致该问题的重大变更？ #

有。TomEE 9.1.x升级OpenWebBeans到4.x系列，而9.0.0-M8使用的是OpenWebBeans 3.x早期版本。OwbNormalScopeProxy类在OpenWebBeans 4.x中被重构，类路径或内部实现发生变化，同时OpenEJB的代理机制也做了调整，导致旧代理生成逻辑无法找到新类。

3. 现有TomEE 9项目的推荐迁移策略是什么？ #

• 分步升级：先从9.0.0-M8升级到TomEE 9.0.x正式版（如9.0.8），解决里程碑版本已知问题后，再升级到9.1.3，最后考虑升级到10.0.0
• 清理依赖：确保项目中所有容器级依赖（如CDI、EJB相关）的scope设为provided，避免打包进WAR包与容器依赖冲突
• 适配代理逻辑：若项目自定义了CDI代理相关逻辑，需适配OpenWebBeans 4.x的新API
• 验证JNDI配置：TomEE 9.1.x对JNDI资源的命名规则和配置方式有细微调整，检查context.xml或tomee.xml中的资源定义是否符合新版本规范

4. TomEE 10是否要求完全兼容Jakarta EE 10才能成功升级？ #

是的。TomEE 10严格实现Jakarta EE 10规范，要求项目完全迁移到Jakarta EE 10的API：

• 所有javax.*包必须替换为jakarta.*
• 依赖版本要对应Jakarta EE 10的规范版本（如CDI 4.0、EJB 4.0等）
• 部分API行为有变更（如JNDI lookup路径、EJB注解使用），需对应调整

5. 升级时如何确保所有Jakarta EE依赖正确解析？ #

• 使用BOM管理依赖：在pom.xml中引入TomEE对应的Jakarta EE BOM，自动统一所有依赖版本，避免版本冲突

  <!-- TomEE 9.1.x对应的Jakarta EE 9.1 BOM -->
  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>jakarta.platform</groupId>
        <artifactId>jakarta.jakartaee-bom</artifactId>
        <version>9.1.0</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  

• 清理冗余依赖：移除项目中不需要的依赖，容器已提供的依赖设为provided，避免打包进WAR包与容器库冲突
• 分析依赖树：使用mvn dependency:tree命令排查是否有旧版本的Jakarta EE或OpenWebBeans依赖被引入
• 验证容器依赖：确保TomEE安装目录下的lib文件夹是对应版本的完整依赖，没有混入旧版本jar包

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