Keycloak 18导入Realm至外部数据库及容器内数据库驱动导入问题

针对你遇到的两个核心问题——在kc.sh start前完成Realm导入、容器中添加MySQL驱动以解决找不到驱动的错误——我整理了可行的解决方案：

一、通过start命令直接完成覆盖导入（推荐方案） #

其实你不需要单独执行import命令，直接在启动Keycloak时结合导入参数，就能实现启动前的覆盖导入，还能避免单独运行import时的驱动缺失问题。

修改你的Docker运行命令如下：

docker run -v ~/realm/:/opt/keycloak/data/import \
  -e KC_DB_PASSWORD=pass \
  -e KC_DB_USERNAME=db \
  -e KC_DB_URL="jdbc:mysql://mydburl/keycloak" \
  -e KC_DB=mysql \
  quay.io/keycloak/keycloak:18.0.2 \
  start --import-realm --override true

这里的关键细节：

• 新增KC_DB=mysql环境变量，明确告诉Keycloak使用MySQL数据库类型，它会自动处理驱动关联逻辑
• 用start命令替代单独的import命令，搭配--import-realm和--override true参数，Keycloak启动时会自动读取挂载目录下的Realm文件，覆盖已存在的同名Realm
• 这种方式下，启动流程会自动完成数据库初始化、驱动加载和Realm导入，一步到位

二、给容器添加MySQL驱动（若需单独执行import命令） #

如果你确实需要单独运行import命令，必须先把MySQL驱动加入容器类路径中，因为官方Keycloak镜像默认不包含MySQL驱动。以下是两种常用方法：

方法1：构建自定义Docker镜像 #

创建一个Dockerfile：

FROM quay.io/keycloak/keycloak:18.0.2

# 下载MySQL驱动到Keycloak的Quarkus驱动目录
RUN curl -L -o /opt/keycloak/lib/quarkus-mysql-jdbc-8.0.29.jar https://repo1.maven.org/maven2/com/mysql/mysql-connector-j/8.0.29/mysql-connector-j-8.0.29.jar

构建自定义镜像：

docker build -t my-keycloak:18.0.2 .

使用自定义镜像执行import命令：

docker run -v ~/realm/:/opt/keycloak/data/import \
  -e KC_DB_PASSWORD=pass \
  -e KC_DB_USERNAME=db \
  -e KC_DB_URL="jdbc:mysql://mydburl/keycloak" \
  -e KC_DB=mysql \
  my-keycloak:18.0.2 \
  import --file /opt/keycloak/data/import/realm-export.json --override true

方法2：本地挂载驱动文件到容器 #

先下载MySQL驱动jar包到本地目录（比如~/drivers/），然后在运行容器时挂载到Keycloak的驱动目录：

docker run -v ~/realm/:/opt/keycloak/data/import \
  -v ~/drivers/mysql-connector-j-8.0.29.jar:/opt/keycloak/lib/quarkus-mysql-jdbc-8.0.29.jar \
  -e KC_DB_PASSWORD=pass \
  -e KC_DB_USERNAME=db \
  -e KC_DB_URL="jdbc:mysql://mydburl/keycloak" \
  -e KC_DB=mysql \
  quay.io/keycloak/keycloak:18.0.2 \
  import --file /opt/keycloak/data/import/realm-export.json --override true

你之前尝试的-Dquarkus.datasource.jdbc.driver=mysql参数无效，是因为Quarkus需要驱动文件存在于类路径中，仅指定驱动类名无法解决文件缺失的问题。

额外提示 #

• Keycloak 18基于Quarkus重构，数据库配置和导入逻辑与旧版本差异较大，推荐使用start命令结合导入参数的方式，更贴合新版本设计
• 确保你的MySQL数据库已创建keycloak库，且数据库用户拥有足够权限（CREATE、ALTER、INSERT等）

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