如何在JBoss中将外部JDBC驱动打包进EAR，无需新增服务端模块

方案可行性结论 #

该方案完全可行，无需在JBoss服务端新增全局模块即可实现JDBC驱动随EAR包一起部署。你之前配置不生效是因为模块引用规则和配套配置没有对齐。

所需配置步骤 #

1. 调整EAR包结构

将JDBC驱动Jar包放入EAR根目录的lib文件夹下（默认类扫描路径），如果自定义存放路径需要在后续配置中额外声明。

2. 配置jboss-deployment-structure.xml

该文件需放在EAR包的META-INF目录下，配置示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="javax.api"/>
            <module name="javax.transaction.api"/>
        </dependencies>
        <!-- 驱动放在自定义路径时才需要加下面的resource-root配置，放在默认lib目录可省略 -->
        <!-- <resources>
            <resource-root path="自定义路径/驱动包名.jar" />
        </resources> -->
    </deployment>
    <!-- 若EAR内包含子部署（如WAR包、EJB Jar包）需要访问该数据源，添加对应子部署配置 -->
    <sub-deployment name="你的子部署包名.war">
        <dependencies>
            <module name="deployment.你的EAR包名.ear" />
        </dependencies>
    </sub-deployment>
</jboss-deployment-structure>

3. 调整standalone.xml的数据源与驱动配置

你之前的模块引用写法错误，无需指定到驱动Jar的路径，直接引用EAR部署模块即可，配置示例如下：

<subsystem xmlns="urn:jboss:domain:datasources:7.0">
    <datasources>
        <datasource jndi-name="java:/自定义数据源名" pool-name="自定义数据源池名" enabled="true" use-java-context="true">
            <connection-url>数据库连接地址</connection-url>
            <driver>自定义驱动标识名</driver>
            <security>
                <user-name>数据库用户名</user-name>
                <password>数据库密码</password>
            </security>
        </datasource>
        <drivers>
            <driver name="自定义驱动标识名" module="deployment.你的EAR完整包名.ear">
                <driver-class>JDBC驱动全类名，如com.mysql.cj.jdbc.Driver</driver-class>
                <!-- 使用XA数据源时添加如下配置 -->
                <!-- <xa-datasource-class>XA驱动全类名，如com.mysql.cj.jdbc.MysqlXADataSource</xa-datasource-class> -->
            </driver>
        </drivers>
    </datasources>
</subsystem>

配置注意事项：

• driver标签的module属性值固定格式为deployment.你的EAR完整包名.ear，不要追加驱动Jar的路径，JBoss会自动从EAR的类路径下扫描加载驱动
• 必须显式声明driver-class或xa-datasource-class，不能省略

异常排查要点 #

• 先确认JBoss控制台的部署列表中你的EAR包状态为正常部署
• 核对配置中所有包名、驱动名的大小写与实际完全一致
• 确认standalone.xml中datasources子系统的版本号与你当前使用的JBoss版本匹配

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