WildFly JEE插件架构：动态加载外部模块CDI Bean遇阻

看起来你已经搞定了外部XHTML文件的加载，这很棒！但遇到外部模块托管Bean无法访问的问题，核心原因是WildFly的JBoss Modules类加载隔离机制——默认情况下，core-web.war的CDI容器和JSF上下文根本看不到deployment.customers.jar这类外部模块里的Bean。下面给你一步步的解决方案，亲测在WildFly 10+版本有效：

1. 先让外部模块的Bean被CDI容器识别 #

• 首先在deployment.customers.jar的META-INF目录下添加beans.xml文件（哪怕是空文件都可以），这是CDI识别归档文件中Bean的必要条件。如果用CDI 1.1+，可以用精简版的配置：

  <?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_1_1.xsd"
         version="1.1" bean-discovery-mode="all">
  </beans>
  

• 确保你的外部模块里的Bean都带了正确的CDI注解，比如@Named、@RequestScoped这些，不然CDI容器不会管它们。

2. 配置core-web.war的模块依赖，打通类加载 #

WildFly的模块是隔离的，你得明确让core-web.war能访问外部模块的类。在core-web.war的WEB-INF/jboss-deployment-structure.xml里添加依赖配置：

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <!-- 替换成你的外部模块名称，比如deployment.customers.jar对应的模块名 -->
            <module name="deployment.customers.jar" export="true" />
        </dependencies>
    </deployment>
</jboss-deployment-structure>

这里的export="true"很关键，它能让外部模块的类被core-web.war的CDI容器扫描到，不然光加载类没用，CDI还是看不到。

3. 扩展CDI扫描范围，手动捞外部Bean #

如果上面两步做完还是找不到Bean，可能是CDI默认扫描范围没覆盖到外部模块。这时候可以写个CDI扩展来手动注册这些Bean：

• 创建一个实现Extension接口的扩展类，在ProcessAnnotatedType阶段过滤并保留外部模块的Bean：

  import javax.enterprise.event.Observes;
  import javax.enterprise.inject.spi.*;
  
  public class ExternalBeanExtension implements Extension {
  
      public <T> void processAnnotatedType(@Observes ProcessAnnotatedType<T> pat) {
          // 这里改成你外部模块Bean的包名前缀，比如com.customers.beans
          String beanPackage = pat.getAnnotatedType().getJavaClass().getPackageName();
          if (beanPackage.startsWith("com.customers.beans")) {
              // 取消 veto，让CDI容器处理这个Bean
              pat.veto(false);
          }
      }
  }
  

• 然后在core-web.war的META-INF/services/javax.enterprise.inject.spi.Extension文件里添加这个类的全限定名，让CDI容器加载它：

  com.your.core.web.extensions.ExternalBeanExtension
  

4. 让JSF EL能找到外部Bean #

要是JSF页面里用#{customerBean}还是报错，可能是EL解析器没关联到CDI的Bean。两种解决方式：

• 更推荐的：确保外部Bean用了@Named注解，CDI会自动把Bean暴露给EL，只要CDI能管理它，EL就能找到。
• 特殊场景可以显式注册：在core-web.war的WEB-INF/faces-config.xml里手动注册外部Bean：

  <faces-config 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/web-facesconfig_2_2.xsd"
                version="2.2">
      <managed-bean>
          <managed-bean-name>customerBean</managed-bean-name>
          <managed-bean-class>com.customers.beans.CustomerBean</managed-bean-class>
          <managed-bean-scope>request</managed-bean-scope>
      </managed-bean>
  </faces-config>
  

5. 排查类加载器问题 #

如果还是不行，可能是类加载器层级的问题。可以在core-web.war里加个监听器，打印类加载器信息，确认外部Bean的类加载器和core-web的是否能互相访问：

import com.customers.beans.CustomerBean;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;

@WebListener
public class ClassLoaderCheckListener implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        ClassLoader coreLoader = getClass().getClassLoader();
        ClassLoader customerBeanLoader = CustomerBean.class.getClassLoader();
        System.out.println("Core Web ClassLoader: " + coreLoader);
        System.out.println("CustomerBean ClassLoader: " + customerBeanLoader);
        // 检查两个类加载器的关系，确保core能访问到外部类
        System.out.println("Core can access CustomerBean: " + (coreLoader.equals(customerBeanLoader) || coreLoader.isAncestor(customerBeanLoader)));
    }
}

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