如何修复JBoss EAP 7.3部署报错WFLYCTL0412：必需服务未安装

核心触发点是类加载失败，报错链里的根因非常明确：
java.lang.NoClassDefFoundError: Failed to link it/eni/italgas/sam/web/urka/GuiSessionSpacchettatore: com/sun/rave/web/ui/appbase/AbstractSessionBean

• 找不到的com.sun.rave.web.ui.appbase.AbstractSessionBean属于Sun Rave（早期Visual JSF/Web UI组件库）的核心基类，你应用里sam-fe-web.war包的GuiSessionSpacchettatore类直接依赖该类，但JBoss EAP 7.3运行环境的类加载路径中没有这个类对应的依赖包，导致部署的POST_MODULE阶段类链接失败。
• 报错里列的WeldStartService未启动、EJB JNDI上下文未注册、beanmanager未安装等问题，全是上述类加载失败引发的连锁报错，不是独立问题，不需要单独排查。

• 第一步：补齐缺失的依赖包
  找到项目编译阶段使用的、包含com.sun.rave.web.ui.appbase.AbstractSessionBean类的jar包（通常包名为webtier-jsf-appbase.jar或带com.sun.rave.web.ui标识的相关jar），按照依赖范围放置：
  • 如果该类仅被sam-fe-web.war内的代码调用，直接将jar放到war包的WEB-INF/lib目录下
  • 如果ear包内的sam-fe-ejb.jar等其他子模块也需要调用该类，将jar放到ear包根目录的lib文件夹下，EAP 7.3符合Java EE 7规范，会自动加载ear/lib目录下的公共依赖，不需要额外在application.xml中声明
    注意必须使用项目编译时对应的版本，不要随意替换版本，否则会触发类版本不兼容、方法缺失的新错误。
• 第二步：检查JBoss模块依赖配置
  如果你之前将Rave相关依赖配置为JBoss全局模块（放在EAP的modules目录下），需要在部署包中显式声明模块依赖：
  • 仅war包需要依赖时，在sam-fe-web.war/WEB-INF/下新建或修改jboss-deployment-structure.xml，添加对应模块依赖，示例配置如下：

``` - 如果是ear包全模块需要依赖，将上述配置放到ear包`META-INF/`目录下的`jboss-deployment-structure.xml`中即可。 - 第三步：排查类冲突 EAP 7.3类加载默认优先加载部署包内的资源，如果你同时在服务器全局模块目录、部署包lib目录下放置了不同版本的Rave依赖，会触发类链接冲突，需要删除重复版本，仅保留和项目编译版本一致的一份依赖即可。

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