Tomcat8.5搭建CDI2.0 Maven项目：WELD3相关问题咨询

一、Weld、CDI与Java EE版本的对应关系 #

先给你理清楚这几个概念的关联：

• CDI（Contexts and Dependency Injection） 是Java EE（现更名为Jakarta EE）中的核心依赖注入规范，定义了一套依赖注入和上下文管理的标准API。
• Weld 是CDI规范的官方参考实现，由JBoss出品，是目前最常用的CDI实现，负责把CDI的标准落地成可运行的代码。

它们的版本对应关系很明确：

• Java EE 7 → CDI 1.2 → Weld 2.x 系列
• Java EE 8 → CDI 2.0 → Weld 3.x 系列
• Jakarta EE 9+ → CDI 3.0+ → Weld 4.x+ 系列

你用的Tomcat 8.5属于Servlet容器（仅实现Servlet/JSP规范），不像WildFly这类全Java EE应用服务器自带CDI支持，所以必须手动引入Weld Servlet来提供CDI能力，选Weld 3.x完全匹配你的CDI 2.0需求。

二、WeldTerminalListener配置错误排查 #

你提到只引入weld-servlet-core后配置监听器出错，大概率是这几个环节没处理好，逐个排查：

1. 检查Maven依赖是否正确 #

确保你的依赖是Weld 3.x版本的weld-servlet-core，示例配置如下：

<dependency>
    <groupId>org.jboss.weld.servlet</groupId>
    <artifactId>weld-servlet-core</artifactId>
    <version>3.1.9.Final</version> <!-- 选一个稳定的3.x版本即可 -->
    <scope>runtime</scope>
</dependency>

注意scope设为runtime就足够，不需要编译时依赖。

2. 监听器类名是否完整且顺序正确 #

你写的org.jboss.weld...是不完整的类名，WeldTerminalListener的全类名是org.jboss.weld.servlet.WeldTerminalListener，并且它必须是最后一个注册的监听器，同时要先注册Weld的初始化监听器：

<!-- 先注册Weld容器初始化监听器 -->
<listener>
    <listener-class>org.jboss.weld.servlet.WeldServletListener</listener-class>
</listener>

<!-- 这个监听器必须放在所有监听器的最后 -->
<listener>
    <listener-class>org.jboss.weld.servlet.WeldTerminalListener</listener-class>
</listener>

⚠️ 关键：WeldServletListener负责启动Weld容器，WeldTerminalListener负责应用停止时销毁容器，顺序颠倒会直接导致初始化失败。

3. 排查Tomcat类加载冲突 #

Tomcat的类加载机制比较特殊，如果项目中混入了其他CDI实现的Jar包（比如OpenWebBeans），会导致类加载冲突，出现找不到类或者初始化异常的问题。确保项目中只有Weld相关的CDI依赖。

4. 确认beans.xml配置（可选但重要） #

CDI 2.0默认的bean发现模式是annotated——只有带@Named、@Singleton等CDI注解的类会被识别为Bean。如果需要扫描所有类，建议在WEB-INF下添加beans.xml：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://xmlns.jcp.org/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/beans_2_0.xsd"
       version="2.0"
       bean-discovery-mode="all">
</beans>

如果按上述步骤调整后仍报错，可以把具体的错误堆栈信息贴出来，这样能更精准定位问题～

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