Keycloak启动时Liquibase操作Oracle数据库报ORA-00942错误

核心原因 #

Keycloak的Liquibase执行迁移SQL时未自动带上指定Schema前缀，而Oracle当前会话默认Schema并非KEYCLOAK，导致找不到目标表。

具体解决方法 #

方法1：在Keycloak数据库连接URL中指定默认Schema #

修改docker-compose里Keycloak的环境变量，给JDBC URL添加currentSchema参数：

services:
  keycloak:
    image: quay.io/keycloak/keycloak:23.0
    environment:
      - KC_DB=oracle
      - KC_DB_URL=jdbc:oracle:thin:@oracle:1521/ORCLPDB1?currentSchema=KEYCLOAK
      - KC_DB_USERNAME=keycloak
      - KC_DB_PASSWORD=your_password
      - KC_HOSTNAME=localhost
      - KC_HTTP_PORT=8080
      - KC_HTTPS_PORT=8443
    depends_on:
      - oracle

该参数会让JDBC连接默认使用KEYCLOAK Schema，Liquibase执行SQL时无需手动指定前缀。

方法2：设置Oracle用户的默认Schema #

直接将KEYCLOAK用户的默认Schema设为自身，执行以下SQL：

ALTER USER keycloak SET DEFAULT SCHEMA keycloak;

执行后，Keycloak连接Oracle时，所有未指定Schema的SQL都会默认指向KEYCLOAK Schema，解决表找不到的问题。

方法3：自定义Keycloak Liquibase配置（不推荐） #

若上述方法不可行，可修改Keycloak的Liquibase changelog文件，给所有表名添加KEYCLOAK.前缀，但此方法需修改源码或自定义镜像，维护成本高，不建议优先使用。

验证方式 #

修改配置后重启Keycloak，观察启动日志，若Liquibase迁移无ORA-00942错误且服务正常启动，即为修复成功。

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