技术求助：迁移数据无法完整导入MariaDB数据库的问题

我之前帮朋友排查过几乎一模一样的问题——Keycloak迁移到MariaDB时表创建不全，Liquibase初始化卡壳。结合经验给你几个实用的排查方向：

1. 先盯紧完整错误日志 #

你贴的日志只到14:18，后面的报错才是核心！去Keycloak的standalone/log/server.log（或者你部署方式对应的日志文件）找完整堆栈。常见的坑包括：

• MariaDB字符集不兼容（比如用了3字节utf8，Keycloak需要4字节utf8mb4，导致字段过长报错）
• 数据库用户权限不够，Liquibase没法创建/修改某些表
• 表名/字段名撞了MariaDB的保留字

2. 核对版本兼容性 #

Keycloak和MariaDB的版本匹配很重要！比如Keycloak 4.x适配MariaDB 10.1~10.3，要是你用了MariaDB 10.5+配旧版Keycloak，大概率会有语法兼容问题。先确认你用的Keycloak版本官方支持的MariaDB范围。

3. 修复MariaDB的关键配置 #

这是最常踩的坑：

• 强制用utf8mb4字符集：创建数据库时执行CREATE DATABASE keycloak CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;，同时在Keycloak的数据源URL里加参数：useUnicode=true&characterEncoding=UTF-8&characterSetResults=UTF-8
• 放宽主键长度限制：MariaDB默认InnoDB主键长度上限767字节，Keycloak部分字段会触发这个限制。修改MariaDB配置文件（my.cnf/my.ini）：

  innodb_large_prefix=ON
  innodb_file_format=Barracuda
  innodb_file_per_table=ON
  

  重启数据库后再试。

4. 手动定位失败的Changelog节点 #

Keycloak的schema更新逻辑在META-INF/jpa-changelog-master.xml，你可以对比H2和MariaDB的分支changelog，看看哪4张表没被创建。或者直接用Liquibase命令行工具，单独执行每个changelog片段，看哪一步报错——这样能精准定位问题。

5. 重置后重新迁移 #

修复问题后，记得清空已创建的87张表（或者直接删库重建），再启动Keycloak让Liquibase重新跑完整的初始化流程，别在半残的库上继续试。

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