WildFly/JBoss部署Derby驱动后创建数据源失败问题求助

问题根因 #

你已成功部署derbyclient.jar，但未在WildFly的数据源子系统中将该部署包注册为JDBC驱动服务，因此创建数据源时无法识别对应的驱动。

解决方案1：基于已部署的derbyclient.jar注册驱动（推荐，无需修改文件系统配置） #

1. 执行以下CLI命令注册JDBC驱动：

[standalone@localhost:9990 /] /subsystem=datasources/jdbc-driver=derbyclient:add(
    driver-name=derbyclient,
    driver-deployment-name=derbyclient.jar,
    driver-class-name=org.apache.derby.jdbc.ClientDriver
)

2. 验证驱动注册成功：
   执行/subsystem=datasources:installed-drivers-list，确认返回结果中已包含derbyclient驱动。
3. 重新创建数据源，按需补充用户名密码配置：

[standalone@localhost:9990 /] /subsystem=datasources/data-source=DVDDerbyDS:add(
    jndi-name=java:jboss/datasources/DVDDerbyDS,
    driver-name=derbyclient,
    connection-url=jdbc:derby://localhost:1527/DVD,
    user-name=你的数据库用户名,
    password=你的数据库密码
)

4. 验证数据源可用性：

[standalone@localhost:9990 /] /subsystem=datasources/data-source=DVDDerbyDS:test-connection-in-pool

返回success即为配置正常。

解决方案2：通过Module方式配置Derby驱动（适合长期固定使用场景） #

1. 停止WildFly服务，在WildFly的modules目录下创建层级目录org/apache/derby/main
2. 将derbyclient.jar放入上述目录，同时新建module.xml文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="org.apache.derby">
    <resources>
        <resource-root path="derbyclient.jar"/>
    </resources>
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

3. 启动WildFly，执行CLI命令注册驱动：

[standalone@localhost:9990 /] /subsystem=datasources/jdbc-driver=derbyclient:add(
    driver-name=derbyclient,
    driver-module-name="org.apache.derby",
    driver-class-name=org.apache.derby.jdbc.ClientDriver
)

后续创建数据源、验证步骤和方案1完全一致。

注意事项 #

• 若你还未创建DVD数据库，可将连接URL改为jdbc:derby://localhost:1527/DVD;create=true，首次连接时会自动创建数据库
• 生产环境建议补充配置连接池参数（最大连接数、最小空闲数、超时时间等），优化资源使用效率。

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