WildFly 31.0.0.Final数据源配置失败：启动时找不到MySQL模块驱动

首先明确：WildFly 31.0.0.Final 与 mysql-connector-j-8.3.0.jar 版本完全兼容，8.3.0支持Jakarta EE 10（WildFly31的基础规范），版本兼容问题可以排除。以下是核心排查方向：

1. 模块依赖配置错误（最可能原因） #

WildFly 31基于Jakarta EE 10，所有原javax前缀的API已替换为jakarta前缀。检查你的com/mysql/main/module.xml，如果依赖仍使用javax.api或javax.transaction.api，会导致驱动模块无法正确加载，进而无法注册jboss.jdbc-driver.mysql服务。

正确的module.xml配置示例：

<?xml version="1.0" encoding="UTF-8"?>
<module name="com.mysql" xmlns="urn:jboss:module:1.9">
    <resources>
        <resource-root path="mysql-connector-j-8.3.0.jar"/>
    </resources>
    <dependencies>
        <module name="jakarta.api"/>
        <module name="jakarta.transaction.api"/>
    </dependencies>
</module>

2. 数据源与驱动的名称不匹配 #

检查standalone.xml中驱动与数据源的关联配置：

• 驱动定义的name属性必须和数据源的driver-name属性完全一致：

  <!-- 驱动定义 -->
  <driver name="mysql" module="com.mysql">
      <driver-class>com.mysql.cj.jdbc.Driver</driver-class>
  </driver>
  
  <!-- 数据源配置 -->
  <datasource jndi-name="java:jboss/datasources/BBStatsDS" pool-name="BBStatsDS" enabled="true">
      <connection-url>jdbc:mysql://localhost:3306/your_db_name?useSSL=false&amp;serverTimezone=UTC</connection-url>
      <driver-name>mysql</driver-name> <!-- 必须和驱动的name属性完全一致 -->
      <security>
          <user-name>db_user</user-name>
          <password>db_pass</password>
      </security>
  </datasource>
  

jboss.jdbc-driver.mysql服务名中的mysql直接来自驱动定义的name属性，二者不匹配会导致数据源找不到对应驱动服务。

3. 模块文件权限问题（类Unix环境） #

如果是Linux/macOS系统，检查mysql-connector-j-8.3.0.jar和module.xml的文件权限：

• 确保WildFly运行用户对com/mysql/main目录下的文件有读取权限
• 执行命令修复权限（假设WildFly运行用户为jboss）：

  chown -R jboss:jboss /path/to/wildfly/modules/system/layers/base/com/mysql
  chmod -R 644 /path/to/wildfly/modules/system/layers/base/com/mysql/main/*
  

4. 控制台缓存与实际加载不一致 #

管理控制台显示驱动正常可能是缓存导致的，实际模块加载失败。可以尝试：

• 删除WildFly缓存目录：rm -rf /path/to/wildfly/standalone/tmp /path/to/wildfly/standalone/data/content
• 重新启动服务器，观察启动日志中是否有模块加载失败的报错信息

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