生产环境Docker部署Keycloak遇JDBC连接失败问题求助

1. 确认MySQL容器状态与网络连通性 #

• 检查MySQL容器是否正常运行：

  docker ps | grep mysql
  

  若容器未运行，重启并查看日志排查启动问题：

  docker start mysql
  docker logs mysql
  

• 验证跨容器网络连通性：
  启动同网络的临时测试容器，测试与MySQL容器的连通性：

  # 测试ICMP连通
  docker run -it --net keycloak-network busybox ping mysql
  # 测试3306端口连通
  docker run -it --net keycloak-network busybox telnet mysql 3306
  

  注意：Docker同网络内可直接用容器名mysql作为主机名访问，若这一步不通，说明网络配置存在问题

2. 验证MySQL数据库与用户配置 #

• 进入MySQL容器，检查数据库和用户权限：

  docker exec -it mysql mysql -uroot -proot
  

  在MySQL命令行执行以下SQL：

  -- 确认keycloak数据库存在
  SHOW DATABASES LIKE 'keycloak';
  -- 确认keycloak用户拥有对应数据库权限
  SHOW GRANTS FOR 'keycloak'@'%';
  

  需确保keycloak用户拥有keycloak数据库的全部操作权限，且允许从任意主机（%）连接。

3. 检查Keycloak镜像构建与启动参数 #

结合你提供的Dockerfile，重点确认以下几点：

• 是否正确引入MySQL JDBC驱动：
  构建镜像时需包含对应版本的JDBC驱动，例如在Dockerfile中添加：

  COPY --from=maven:3.8.6-openjdk-11 /usr/share/maven/repository/mysql/mysql-connector-java/8.0.33/mysql-connector-java-8.0.33.jar /opt/keycloak/providers/
  

  或通过构建参数指定数据库类型自动引入驱动：

  docker build -t my-keycloak --build-arg KC_DB=mysql .
  

• 启动Keycloak时需传入正确的数据库连接参数：

  docker run -d --name keycloak --net keycloak-network -p 8080:8080 \
    -e KC_DB=mysql \
    -e KC_DB_URL=jdbc:mysql://mysql:3306/keycloak?useSSL=false&allowPublicKeyRetrieval=true \
    -e KC_DB_USERNAME=keycloak \
    -e KC_DB_PASSWORD=password \
    -e KC_HOSTNAME=localhost \
    my-keycloak start
  

  注意：JDBC URL中的主机名必须是MySQL容器名mysql，不能用localhost或宿主机IP——容器内的localhost指向自身，无法访问同网络的其他容器

4. 查看Keycloak日志定位具体错误 #

启动Keycloak后，查看完整日志获取更精准的错误信息：

docker logs keycloak

常见细分错误包括：驱动缺失、用户名/密码错误、数据库未就绪等，日志会给出明确提示。

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