Keycloak 22.0.1数据库SQL schema导出方案咨询

Keycloak 17+基于Quarkus架构重构，原有的legacy JPA SPI已被弃用，所以你尝试的旧参数和环境变量都不再生效。以下是针对22.0.1版本的有效解决方案：

方案一：使用专用导出命令生成SQL（推荐） #

Keycloak提供了直接导出数据库schema的命令，无需启动服务，操作更简洁：

执行以下命令，替换对应参数为你的数据库信息：

kc.sh export --db <数据库类型> --db-url <数据库连接URL> --db-username <用户名> --db-password <密码> --schema-only --file <输出SQL路径>

示例（MySQL）： #

kc.sh export --db mysql --db-url jdbc:mysql://localhost:3306/keycloak?useSSL=false --db-username root --db-password your_password --schema-only --file ./keycloak-init.sql

参数说明：

• --schema-only：仅导出数据库结构，不包含测试或示例数据
• --db：指定数据库类型，支持mysql、postgres、mssql等官方适配类型
• 执行完成后，指定路径下会生成完整的初始化SQL脚本，直接在数据库中执行即可完成准备。

方案二：启动时通过Liquibase配置导出并禁止自动执行 #

如果需要通过启动Keycloak的方式生成SQL，需使用Quarkus架构下的Liquibase相关SPI参数：

命令行启动方式： #

kc.sh start \
  --spi-connections-jpa-liquibase-change-log=base \
  --spi-connections-jpa-liquibase-export-changes-sql=/path/to/keycloak-init.sql \
  --spi-connections-jpa-liquibase-enabled=false

环境变量方式： #

export KC_SPI_CONNECTIONS_JPA_LIQUIBASE_EXPORT_CHANGES_SQL=/path/to/keycloak-init.sql
export KC_SPI_CONNECTIONS_JPA_LIQUIBASE_ENABLED=false
kc.sh start

参数说明：

• --spi-connections-jpa-liquibase-enabled=false：禁用Keycloak启动时自动执行数据库迁移
• --spi-connections-jpa-liquibase-export-changes-sql：指定生成的SQL脚本输出路径
• 执行时需确保目标数据库已提前创建（空库即可，无需任何表），Keycloak连接数据库后会生成所有初始化SQL到指定文件，之后可终止Keycloak进程，手动执行SQL完成准备。

注意事项 #

1. 生成SQL前需提前创建空的目标数据库（如CREATE DATABASE keycloak;）
2. 手动执行完SQL后，后续启动Keycloak无需添加任何迁移相关参数，直接正常启动即可
3. 若使用容器化部署，可将导出命令作为初始化步骤，或挂载生成的SQL脚本到容器中执行

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