Eclipse+WildFly+Jakarta Faces环境下JSF应用Bean无法生效问题排查

问题背景 #

此前在旧版Tomcat+javax.faces.2.3.8环境正常运行，迁移到Ubuntu 24.04.3 + Eclipse 2026-03+JBoss Tools + WildFly 37.0.1（内置Jakarta Faces）后，出现以下问题：

• 页面可正常渲染，但自定义UserBean无法生效，EL表达式#{userbean.fullname}无输出，编写时无代码提示
• 服务器启动时出现警告：WARN [org.jboss.as.ee] (MSC service thread 1-6) WFLYEE0007: Not installing optional component org.jboss.weld.environment.servlet.Listener due to an exception
• 移除PrimeFaces依赖后问题仍存在

排查步骤 #

1. 修复UserBean的构造函数问题 #

你的UserBean仅定义了带参数的构造函数，CDI容器必须通过无参构造函数实例化Bean，添加无参构造函数：

public UserBean() {
    // 空实现即可
}

原因：缺少无参构造函数时，CDI容器无法创建Bean实例，直接导致EL表达式找不到对应对象。

2. 修正web.xml的版本与命名空间冲突 #

当前web.xml混合了旧版J2EE和Jakarta EE的配置，WildFly 37对应Jakarta EE 10，需替换为正确的web-app配置：

<?xml version="1.0" encoding="UTF-8"?>
<web-app 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/web-app_6_0.xsd"
         version="6.0">
  <display-name>Test</display-name>
  <welcome-file-list>
    <welcome-file>index.xhtml</welcome-file>
  </welcome-file-list>
  <context-param>
    <param-name>jakarta.faces.PROJECT_STAGE</param-name>
    <param-value>Development</param-value>
  </context-param>
  <servlet>
    <servlet-name>Faces Servlet</servlet-name>
    <servlet-class>jakarta.faces.webapp.FacesServlet</servlet-class>
  </servlet>
  <servlet-mapping>
    <servlet-name>Faces Servlet</servlet-name>
    <url-pattern>*.xhtml</url-pattern>
  </servlet-mapping>
</web-app>

同时删除原web.xml中的org.jboss.weld.environment.servlet.Listener配置：WildFly内置Weld容器，无需手动注册该监听器，手动添加会触发WFLYEE0007警告。

3. 验证CDI Bean扫描配置 #

• 确保beans.xml放置在WEB-INF/目录下（Web项目优先路径）
• 当前beans.xml的bean-discovery-mode="all"配置正确，若UserBean所在包不在默认扫描范围，需添加<scan>节点指定包路径：

<scan>
  <package>你的bean所在包路径</package>
</scan>

4. 调整Eclipse项目配置 #

• 将Dynamic Web Module版本调整为6.0（对应Jakarta EE 10，匹配WildFly 37版本），当前配置为6.1需修正
• 右键项目→Properties→Project Facets，确认Contexts and Dependency Injection已勾选，版本对应Jakarta EE 10
• 执行Project→Clean清理项目，重新部署到WildFly，避免IDE缓存导致代码未同步

5. 查看WildFly CDI初始化日志 #

在WildFly的standalone/configuration/standalone.xml中添加Weld的DEBUG日志配置：

<logger category="org.jboss.weld">
    <level name="DEBUG"/>
</logger>

重启服务器后，查看standalone/log/server.log，搜索UserBean相关日志，确认Bean是否被容器检测并实例化。

6. 测试最简场景 #

创建极简测试页面和Bean，排除模板页、其他Bean的干扰：

• 新建test.xhtml，仅包含<h:outputLabel value="#{userbean.fullname}"/>
• 简化UserBean，仅保留@Named、@SessionScoped注解、无参构造函数和fullname属性
• 访问test.xhtml，观察是否正常输出数据，缩小问题范围

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