Maven多模块项目无法在WildFly服务器部署的问题排查咨询

报错根源拆解 #

从WildFly抛出的JBAS014771: Services with missing/unavailable dependencies日志来看，部署失败是由数据源JNDI匹配错误引发的连锁反应，并非Weld/CDI配置本身有问题：

1. 核心触发点：持久化单元启动时找不到对应JNDI路径的数据源
   • 错误日志里显示查找的数据源路径是jboss.naming.context.java."\"java:jboss\".datasources.\"DBNAME\""，路径里带了嵌套的多余引号，和standalone.xml里配置的真实数据源路径完全不匹配。
   • 因为数据源初始化失败，连带触发Weld容器的BeanManager注册流程中断，才会出现EAR、WAR两层的weld.weldClassIntrospector is missing [*.beanmanager]报错——这类报错是典型的前置服务启动失败的连带表现，不需要修改beans.xml的配置。
2. 配置中存在的其他隐性错配，就算JNDI匹配成功也会影响正常运行：
   • persistence.xml里的数据库方言配置完全写法错误：把H2方言的类名当成了属性键，实际配置的hibernate.dialect值是空的，就算数据源连上也会出现SQL语法不兼容的问题。
   • 实际用的是MySQL数据源，但配置里指向H2的方言，和使用场景不匹配。

逐步骤修正操作 #

• 第一步：修正persistence.xml中的数据源引用
  把<jta-data-source>节点里多余包裹的引号删掉，不要在XML文本值里额外加双引号，改成：

  <jta-data-source>java:jboss/datasources/DBNAME</jta-data-source>
  

  注意：XML标签的文本内容本身不需要手动加引号，之前多打的首尾引号会被WildFly直接当成JNDI路径的组成部分，导致名称完全匹配不上。
• 第二步：修正数据库方言配置
  删掉原来错误的方言配置段落，替换为匹配实际MySQL版本的正确写法：

  <!-- MySQL 8.x 用这个配置，MySQL 5.x 替换为org.hibernate.dialect.MySQL5Dialect -->
  <property name="hibernate.dialect" value="org.hibernate.dialect.MySQL8Dialect"/>
  

• 第三步：校验WildFly数据源可用性
  启动WildFly后，通过管理控制台进入数据源配置页，选中DBNAME数据源点击“测试连接”，确认能正常连通本地MySQL服务：
  • 检查mysqlDriver是否在WildFly的驱动列表中完成注册，没有出现驱动缺失的告警
  • 检查root用户的密码是否和实际MySQL的认证信息匹配（原配置里密码是空的，和多数本地MySQL的默认配置不符，容易出现连接认证失败）
• 第四步：清理部署残留后重新打包
  • 进入WildFly的standalone/deployments目录，删除所有和PROJECTNAME相关的残留文件，包括部署失败标记、临时解压的目录碎片
  • 回到本地项目执行全量Maven清理操作：先运行mvn clean install重新生成所有模块的打包产物，不要直接使用之前编译生成的旧EAR包
  • 将新生成的EAR包上传到服务器触发部署，即可正常启动。

补充说明：该问题在从单模块动态Web项目切换为Maven多模块结构时高发，核心原因是手动迁移配置时，不小心把复制粘贴带来的多余引号留在了persistence.xml中——之前单模块项目的配置一般是IDE自动生成的，不会出现这类冗余字符，因此部署一直正常。

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