Jboss EAP7.1/Wildfly Oracle数据源错误：依赖服务缺失/不可用

嘿，这个问题我碰到过好多次了，核心就是你的Oracle驱动没被JBoss正确识别，或者数据源配置里的驱动引用和实际部署的驱动名称对不上。咱们一步步来搞定：

第一步：确认Oracle驱动的部署方式是否正确 #

JBoss加载JDBC驱动主要有两种方式，你得先对应上自己的部署方式：

方式1：模块部署（推荐生产环境） #

你需要把Oracle驱动jar包放到$JBOSS_HOME/modules/system/layers/base/com/oracle/main目录下（如果目录不存在就手动创建），然后在这个目录里新建一个module.xml文件，内容要确保driver-name是你数据源里用的oracle11g，示例如下：

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="com.oracle">
    <resources>
        <!-- 这里要替换成你实际的Oracle驱动jar包名称 -->
        <resource-root path="ojdbc6.jar"/>
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

方式2：部署包部署（适合测试环境） #

直接把Oracle驱动jar包丢到$JBOSS_HOME/standalone/deployments目录下，JBoss启动时会自动扫描部署。注意jar包后缀必须是.jar，部署成功后目录里会生成一个同名的.deployed标记文件。

第二步：检查数据源与驱动的配置匹配 #

打开你的standalone.xml，找到数据源配置部分，确保里面明确指定了驱动名称，并且和驱动配置里的name一致：

数据源配置片段 #

<datasource jndi-name="java:jboss/datasources/CreditDS" pool-name="CreditDS" enabled="true">
    <connection-url>jdbc:oracle:thin:@//你的数据库地址:端口/服务名</connection-url>
    <driver>oracle11g</driver> <!-- 这里必须和下面驱动配置的name一致 -->
    <security>
        <user-name>你的用户名</user-name>
        <password>你的密码</password>
    </security>
</datasource>

驱动配置片段（在<drivers>标签下） #

如果是模块部署，驱动配置应该是这样：

<driver name="oracle11g" module="com.oracle">
    <driver-class>oracle.jdbc.OracleDriver</driver-class>
    <xa-datasource-class>oracle.jdbc.xa.client.OracleXADataSource</xa-datasource-class>
</driver>

如果是部署包部署，驱动配置会更简单（JBoss自动生成，你也可以手动指定）：

<driver name="oracle11g" module="deployment.ojdbc6.jar">
    <driver-class>oracle.jdbc.OracleDriver</driver-class>
</driver>

第三步：验证驱动是否成功加载 #

启动JBoss后，你可以用CLI工具来检查驱动状态：

1. 进入$JBOSS_HOME/bin目录，执行./jboss-cli.sh --connect（Windows用.bat）
2. 输入命令：/subsystem=datasources/jdbc-driver=oracle11g:read-resource
   如果返回正常的驱动信息，说明加载成功；如果提示找不到，那就要回头检查部署和配置的细节了。

另外也可以看JBoss的启动日志，搜索oracle11g，如果看到类似Registered JDBC driver with driver-name=oracle11g的日志，就说明驱动加载没问题。

几个容易踩的坑 #

• 驱动jar包版本要和Oracle数据库版本尽量匹配，比如11g的库用ojdbc6，12c用ojdbc7/8，避免兼容性问题
• 模块部署时，module.xml里的resource-root path要和实际jar包文件名完全一致，别打错字
• 如果是部署包方式，别把jar包放到子目录里，直接丢到deployments根目录下

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