无法为Keycloak配置PostgreSQL数据源求助

我之前在配置老版本Keycloak的时候也碰到过一模一样的问题，这个报错本质是WildFly（Keycloak 3.x基于WildFly）没有正确识别到PostgreSQL的JDBC驱动模块，跟你用的驱动版本关系不大，主要是驱动的安装方式和配置匹配度的问题。下面是我当时解决的步骤，你可以一步步核对：

1. 正确安装PostgreSQL驱动模块 #

WildFly不会自动识别随便放置的JDBC驱动，必须把驱动放到指定的模块目录并配置module.xml：

• 先创建目录：keycloak-3.0.0.Final/modules/system/layers/base/org/postgresql/main（如果目录不存在就逐层创建）
• 把你下载的PostgreSQL JDBC jar包（比如postgresql-9.4.1212.jar）放到这个目录里
• 在同一目录下创建module.xml文件，内容如下（注意替换jar文件名）：

  <?xml version="1.0" encoding="UTF-8"?>
  <module xmlns="urn:jboss:module:1.1" name="org.postgresql">
      <resources>
          <resource-root path="postgresql-9.4.1212.jar"/> <!-- 这里改成你实际的jar文件名 -->
      </resources>
      <dependencies>
          <module name="javax.api"/>
          <module name="javax.transaction.api"/>
      </dependencies>
  </module>
  

  这里的name="org.postgresql"是模块的唯一标识，后面配置驱动时要对应上。

2. 核对standalone.xml里的驱动配置 #

打开standalone.xml，找到<subsystem xmlns="urn:jboss:domain:datasources:4.0">下的<drivers>节点，确保PostgreSQL驱动的配置正确：

<driver name="postgres-driver" module="org.postgresql">
    <driver-class>org.postgresql.Driver</driver-class>
    <xa-datasource-class>org.postgresql.xa.PGXADataSource</xa-datasource-class>
</driver>

重点注意：

• name="postgres-driver"这个名称要和你后面数据源配置里的driver-name完全一致
• module="org.postgresql"必须和刚才module.xml里的模块名一致

3. 检查KeycloakDS的数据源配置 #

找到<datasource>节点里的KeycloakDS配置，确保driver字段指向上面的驱动名称：

<datasource jndi-name="java:jboss/datasources/KeycloakDS" pool-name="KeycloakDS" enabled="true" use-java-context="true">
    <connection-url>jdbc:postgresql://localhost:5432/keycloak</connection-url> <!-- 替换成你的数据库地址和库名 -->
    <driver>postgres-driver</driver> <!-- 这里必须和驱动配置的name一致 -->
    <security>
        <user-name>你的数据库用户名</user-name>
        <password>你的数据库密码</password>
    </security>
</datasource>

别犯低级错误：比如把<driver>写成<driver-class>，或者驱动名称拼写错误。

4. 验证驱动是否被正确加载 #

如果还是报错，可以启动服务器时加上调试日志参数：

standalone.bat -Dorg.jboss.logging.level=DEBUG

查看启动日志里有没有加载org.postgresql模块的信息，如果没有，说明模块目录或者module.xml有问题。

另外，也可以用WildFly的CLI工具检查：

• 运行bin/jboss-cli.bat
• 输入connect连接服务器
• 执行命令：/subsystem=datasources/driver=postgres-driver:read-resource
  如果返回找不到驱动，那肯定是驱动模块没装对。

关于文档过时的问题 #

Keycloak 3.0.0确实是比较老的版本了，官方文档可能省略了一些模块配置的细节，你碰到的邮件列表问题大概率也是驱动模块安装不正确导致的。

按照上面的步骤一步步核对，应该能解决这个依赖缺失的问题。

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