Docker Compose部署Keycloak+MySQL无法存储数据求助

我之前也碰到过类似的Keycloak连接MySQL后无法自动建表的情况，咱们从几个关键环节一步步排查：

1. 先确认Keycloak的数据库连接配置是否完整正确 #

你只贴了MySQL的配置，但Keycloak的环境变量是核心——如果它没拿到正确的数据库参数，根本没法连接初始化。你需要确保Keycloak服务的配置里包含这些关键环境变量：

services:
  keycloak:
    # 其他配置...
    environment:
      DB_VENDOR: MYSQL
      DB_ADDR: lab-mysql  # 要和MySQL的容器名一致，Docker内部可以用容器名解析
      DB_DATABASE: keycloak  # 和你MySQL里创建的库名一致
      DB_USER: your_k_user  # 你配置的MYSQL_USER的完整值（你之前的配置里只写了k...）
      DB_PASSWORD: your_k_password  # 别忘了给这个用户设置密码！你当前的MySQL配置里没指定MYSQL_PASSWORD，这大概率是问题之一！
      KEYCLOAK_ADMIN: admin
      KEYCLOAK_ADMIN_PASSWORD: admin

注意：你的MySQL配置里只定义了MYSQL_USER，但没设置MYSQL_PASSWORD，Keycloak用这个用户连接时会因为密码错误失败，这是很常见的疏漏。

2. 检查MySQL用户的权限是否足够 #

即使创建了用户，默认情况下它可能没有操作keycloak数据库的权限。你可以进入MySQL容器手动授权：

docker exec -it lab-mysql mysql -uroot -ppassword
# 执行授权命令
GRANT ALL PRIVILEGES ON keycloak.* TO 'your_k_user'@'%';
FLUSH PRIVILEGES;

如果想自动完成授权，可以在docker-compose里给MySQL挂载一个初始化SQL脚本：

lab-mysql:
  # 其他配置...
  volumes:
    - ./init.sql:/docker-entrypoint-initdb.d/init.sql

init.sql内容：

GRANT ALL PRIVILEGES ON keycloak.* TO 'your_k_user'@'%';
FLUSH PRIVILEGES;

3. 验证容器间的网络连通性 #

确保Keycloak和MySQL在同一个Docker网络里（默认情况下version 2的compose会创建默认网络，所有服务都在里面，但还是确认下）：
进入Keycloak容器，尝试ping MySQL容器：

docker exec -it <keycloak-container-name> ping lab-mysql

如果ping不通，说明网络有问题，可以在compose里显式定义网络：

version: '2'
networks:
  keycloak-network:
    driver: bridge

services:
  lab-mysql:
    # 其他配置...
    networks:
      - keycloak-network
  keycloak:
    # 其他配置...
    networks:
      - keycloak-network

4. 查看日志找具体报错 #

这是最直接的方式：

• 查看MySQL日志，看有没有连接失败、权限拒绝的记录：

docker logs lab-mysql

• 查看Keycloak日志，找数据库连接、初始化相关的报错（比如驱动问题、密码错误、数据库不存在）：

docker logs <keycloak-container-name>

日志里的错误信息会直接告诉你问题所在，比如Access denied for user 'xxx'@'xxx'就是权限/密码问题，Unknown database 'keycloak'就是库没创建对。

5. 检查MySQL的字符集配置 #

Keycloak要求MySQL使用utf8mb4字符集，否则可能在初始化表时失败。给MySQL添加字符集配置：

lab-mysql:
  # 其他配置...
  command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci

先从这几点排查，尤其是Keycloak的完整配置和MySQL用户密码、权限的问题，大概率能解决。

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