JBoss EAP 7.1域模式下使用CLI部署无法加载静态模块问题

域模式和独立模式的运行机制差异不小，独立模式能跑不代表域模式下直接部署就能成功，我帮你梳理几个核心排查方向和解决步骤：

1. 先确认静态模块的域级可见性 #

你在EAP_HOME/modules下配置的静态模块，理论上域和独立模式都能访问，但要确保模块本身的配置没问题：

• 打开EAP_HOME/modules/com/organization/global/main/module.xml，检查模块定义是否规范，比如：

  <?xml version="1.0" encoding="UTF-8"?>
  <module xmlns="urn:jboss:module:1.3" name="com.organization.global">
      <resources>
          <!-- 这里要包含模块依赖的所有jar包，别漏了 -->
          <resource-root path="your-required-lib.jar"/>
      </resources>
      <dependencies>
          <!-- 按需添加模块依赖，比如基础API依赖 -->
          <module name="javax.api"/>
      </dependencies>
  </module>
  

• 还要确认模块的目录结构完全匹配com/organization/global/main，大小写也不能错，JBoss对模块路径的大小写敏感。

2. 确保服务器组的Profile加载了你的模块 #

域模式下，每个服务器组对应一个Profile，你需要把静态模块添加到Profile的全局模块列表里，否则服务器组里的实例找不到这个模块：

1. 连接到域控制器的CLI：

   ./jboss-cli.sh --connect
   

2. 先查清楚main-server-group用的是哪个Profile：

   /host=master/server-group=main-server-group:read-attribute(name=profile)
   

   假设返回的Profile是full，继续下一步
3. 把你的模块添加到这个Profile的EE子系统全局模块中：

   /profile=full/subsystem=ee:write-attribute(name=global-modules, value=[{name=com.organization.global, slot=main}])
   

4. 重启服务器组让配置生效：

   /host=master/server-group=main-server-group:restart-servers()
   

3. 检查部署命令的细节 #

再核对下你用的部署命令，几个容易踩坑的点：

• 确保EAR包的路径是绝对路径，比如/opt/deploy/myservice.ear，相对路径在域模式下可能会因为工作目录问题找不到文件
• 确认main-server-group确实存在，可以用这个命令验证：

  /server-group=main-server-group:read-resource()
  

• 如果部署时提示权限问题，检查你用的管理用户是否有deployer或admin角色，没有的话用./add-user.sh重新添加用户并分配对应角色

4. 查看日志定位具体错误 #

上面的步骤如果都没问题，就去日志里找线索：

• 域控制器的日志：tail -f EAP_HOME/domain/logs/host-controller.log，这里会记录部署请求的处理过程
• 服务器组中实例的日志：比如tail -f EAP_HOME/domain/logs/server-one.log（如果服务器实例是server-one），这里会记录应用启动时的具体错误，比如依赖缺失、类加载失败等

5. 检查EAR包的部署结构配置 #

如果你的EAR依赖这个静态模块，最好在EAR的META-INF/jboss-deployment-structure.xml里显式声明依赖，避免类加载问题：

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="com.organization.global" slot="main"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

按照这个流程一步步排查，应该能找到部署失败的原因并解决。

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