WildFly 27迁移部署报错：Oracle JDBC驱动类不可访问求助

核心原因与修复步骤 #

1. 给应用添加驱动模块依赖 #

WildFly 27对模块可见性管控更严，哪怕驱动在base层，应用也得主动声明依赖：

• 在应用的WEB-INF或META-INF目录下新建/修改jboss-deployment-structure.xml，加入驱动模块的依赖配置：

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <!-- 模块名要和你实际的Oracle驱动模块名一致，比如有的是com.oracle.jdbc -->
            <module name="com.oracle.ojdbc" slot="main" export="true"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

• 同时检查驱动模块的module.xml，确保它开放了导出权限：

<module xmlns="urn:jboss:module:1.9" name="com.oracle.ojdbc">
    <resources>
        <resource-root path="ojdbc8.jar"/> <!-- 这里要和实际驱动jar名一致 -->
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
    <exports>
        <export module="*"/>
    </exports>
</module>

2. 核对驱动模块的路径与命名 #

• 确认驱动模块的路径是modules/system/layers/base/com/oracle/ojdbc/main（对应模块名com.oracle.ojdbc），路径或模块名错了的话，应用根本找不到驱动。
• 检查module.xml里的resource-root path是否和实际的驱动jar文件名完全匹配，比如用的是ojdbc11.jar就改成对应名称。

3. 修正数据源的驱动配置 #

• 去WildFly管理控制台或者standalone.xml/domain.xml里，检查数据源的driver-class是否正确，Oracle 19c及以上要用oracle.jdbc.OracleDriver，别用旧的oracle.jdbc.driver.OracleDriver。
• 同时确认数据源的driver-name和驱动模块的名称一致。

4. 清理应用包内的重复驱动 #

• 解压你的war/ear包，检查WEB-INF/lib里有没有ojdbc相关的jar包，有的话直接删掉——应用自带驱动会和WildFly模块里的驱动冲突，导致类加载混乱。

5. 调整类加载优先级（可选） #

如果上面的方法都不行，试试在jboss-deployment-structure.xml里加类加载优先级配置，让应用优先使用WildFly模块里的驱动：

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <module name="com.oracle.ojdbc" slot="main" export="true"/>
        </dependencies>
        <classloading>
            <module-name>com.oracle.ojdbc</module-name>
            <priority>100</priority>
        </classloading>
    </deployment>
</jboss-deployment-structure>

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