Keycloak数据库更新失败求助：APPLICATION_DEFAULT_ROLES表已存在

问题分析 #

这个错误是Keycloak的Liquibase数据库迁移工具尝试创建已存在的表导致的，常见原因包括：

• 数据库残留了之前Keycloak部署的旧表
• Liquibase的DATABASECHANGELOG表记录异常，未标记该迁移任务已执行
• Docker MySQL卷中留存了未清理的旧数据

解决方案 #

1. 测试环境：清空数据库重新部署 #

如果是测试环境，直接清理数据库后重启服务：

• 登录MySQL执行SQL：

  DROP DATABASE IF EXISTS keycloak;
  CREATE DATABASE keycloak CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  

• 重启Keycloak容器，让它重新执行完整的数据库迁移流程。

2. 生产环境：修复Liquibase迁移记录 #

若无法清空数据库，手动修正DATABASECHANGELOG表记录：

1. 检查目标迁移记录是否存在：

   SELECT * FROM keycloak.DATABASECHANGELOG WHERE ID = '1.0.0.Final-KEYCLOAK-5461';
   

2. 若记录不存在但表已创建，手动插入迁移记录（替换占位符为实际值）：

   INSERT INTO keycloak.DATABASECHANGELOG (ID, AUTHOR, FILENAME, DATEEXECUTED, ORDEREXECUTED, EXECTYPE, MD5SUM, DESCRIPTION, COMMENTS, TAG, LIQUIBASE, CONTEXTS, LABELS, DEPLOYMENT_ID)
   VALUES ('1.0.0.Final-KEYCLOAK-5461', 'sthorger@redhat.com', 'META-INF/jpa-changelog-1.0.0.Final.xml', NOW(), 1, 'EXECUTED', '8:abc123def456', 'createTable tableName=APPLICATION_DEFAULT_ROLES', '', NULL, '3.8.0', NULL, NULL, 'deployment-123');
   

   注：MD5值可从Keycloak启动日志中找到对应迁移记录的MD5，也可跳过该字段让Liquibase自动验证
3. 若记录存在但状态为FAILED，更新状态为已执行：

   UPDATE keycloak.DATABASECHANGELOG SET EXECTYPE = 'EXECUTED' WHERE ID = '1.0.0.Final-KEYCLOAK-5461';
   

3. 清理Docker MySQL卷（Docker部署场景） #

如果MySQL使用Docker卷存储数据，旧数据可能残留：

# 停止并删除容器及关联卷
docker-compose down -v
# 重新启动服务
docker-compose up -d

注：此操作会删除MySQL所有数据，仅适用于测试环境

4. 验证Keycloak配置 #

确认Keycloak数据库配置正确，无强制覆盖迁移的参数：

# docker-compose.yml中Keycloak服务环境变量示例
environment:
  - DB_VENDOR=mysql
  - DB_ADDR=mysql
  - DB_DATABASE=keycloak
  - DB_USER=keycloak
  - DB_PASSWORD=your_secure_password
  # 确保未设置以下强制覆盖参数
  # - KEYCLOAK_MIGRATION_STRATEGY=OVERWRITE_EXISTING

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