Java 11升级至Java 17后使用weld-junit5遭遇NoClassDefFound javax/enterprise/inject/spi/BeanManager错误

我之前在从Java 11升级到17并搭配Weld JUnit 5做测试时，也碰到过几乎一模一样的问题——编译正常但跑测试时就抛出javax/enterprise/inject/spi/BeanManager找不到的错误。核心原因是Java 17适配的Jakarta EE 9+（也就是你用的jakarta.*命名空间），和旧的javax.*依赖完全不兼容，哪怕是一个间接依赖残留的javax类都会引发这类类加载问题。结合你的pom配置，我整理了几个具体的排查和解决步骤：

1. 先揪出偷偷引入javax.enterprise的依赖 #

你已经替换了所有显式依赖和代码里的javax为jakarta，但大概率是某个间接依赖悄悄引入了旧的javax版CDI API。用Maven的依赖树命令就能精准定位：

mvn dependency:tree -Dincludes=javax.enterprise

执行后会输出所有引入javax.enterprise相关依赖的模块，找到对应的依赖后，在你的pom.xml中给它加上排除规则即可。

2. 修正Weld JUnit 5的依赖配置 #

你的weld-junit5版本5.0.1本身是支持Jakarta EE 9+的，但手动排除太多依赖反而可能导致Weld无法加载正确的Jakarta核心库。建议调整为以下配置：

<dependency>
    <groupId>org.jboss.weld</groupId>
    <artifactId>weld-junit5</artifactId>
    <version>5.0.1.Final</version>
    <scope>test</scope>
    <!-- 批量排除所有javax开头的依赖，从根源避免冲突 -->
    <exclusions>
        <exclusion>
            <groupId>javax.*</groupId>
            <artifactId>*</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- 显式引入Jakarta版本的Weld SE核心库，确保类路径上只有jakarta.*的CDI实现 -->
<dependency>
    <groupId>org.jboss.weld.se</groupId>
    <artifactId>weld-se-shaded</artifactId>
    <version>5.0.1.Final</version>
    <scope>test</scope>
</dependency>

用weld-se-shaded是因为它已经打包了所有必要的Jakarta依赖，不会再引入任何javax版本的类。

3. 检查beans.xml的规范版本和命名空间 #

你提到已经更新了beans.xml到CDI 3.0，但要确保它用的是Jakarta的新命名空间，而不是旧的Java EE命名空间：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="https://jakarta.ee/xml/ns/jakartaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/beans_3_0.xsd"
       version="3.0"
       bean-discovery-mode="all">
</beans>

如果还是用旧的http://xmlns.jcp.org/xml/ns/javaee命名空间，Weld会默认切换到javax模式，直接触发类找不到的错误。

4. 确保Maven编译插件的Java版本配置正确 #

Java 17对模块系统的限制更严格，要在Maven编译插件中明确指定版本，同时确保CDI模块被正确加载：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.11.0</version>
            <configuration>
                <source>17</source>
                <target>17</target>
                <!-- 显式添加Jakarta CDI模块，避免模块系统找不到类 -->
                <compilerArgs>
                    <arg>--add-modules=jakarta.enterprise.cdi-api</arg>
                </compilerArgs>
            </configuration>
        </plugin>
    </plugins>
</build>

5. 最后检查测试代码的注解细节 #

虽然你说已经替换了所有javax代码，但还是要扫一遍测试类里的CDI注解——比如有没有不小心用了javax.inject.Inject而不是jakarta.inject.Inject，这类小细节很容易被忽略。

按这个流程走下来，基本就能解决BeanManager找不到的问题。我当时就是通过依赖树发现是一个旧版本的测试扩展库偷偷引入了javax依赖，排除后测试就正常跑起来了。

内容来源于stack exchange