Docker 中 MySQL 多实例连接故障排查：快速解决“连接被拒绝”错误

Docker 中 MySQL 多实例连接故障排查：排除“连接被拒绝”错误

引言

在 Docker 环境中使用 MySQL 多实例时，可能会遇到“mysqli::real_connect()： (HY000/2002)：连接被拒绝”错误，阻碍对某些实例的访问。本文将深入探讨此错误的潜在原因并提供分步解决方法，帮助您恢复数据库连接。

问题分析

此错误表明 PHPMyAdmin 无法连接到特定的 MySQL 实例（DB2）。原因可能归因于以下因素：

• 网络配置： 实例间的网络连接中断或配置不当。
• 端口映射： PHPMyAdmin 容器和目标 MySQL 容器之间的端口映射不正确。
• PHPMyAdmin 配置： PHPMyAdmin 配置文件中的连接信息与 DB2 实例不匹配。

解决步骤

1. 检查网络配置

• 确保 DB2 容器正在运行并已连接到适当的网络。
• 使用 docker network ls 命令检查 Docker 网络列表。

2. 检查端口映射

• 确认 PHPMyAdmin 容器的端口映射指向 DB2 容器的正确端口（例如，3307）。
• 使用 docker ps 命令查看容器详细信息。

3. 检查 PHPMyAdmin 配置

• 打开 phpmyadmin 的 config.inc.php 文件。
• 检查 $cfg['Servers'][$i]['host'] 选项是否设置为 DB2 容器的 IP 地址或容器名称。
• 检查 $cfg['Servers'][$i]['port'] 选项是否设置为 DB2 容器的端口。

4. 检查连接信息

• 确保 PHPMyAdmin 中使用的用户名和密码与 DB2 实例中的 root 用户信息匹配。
• 使用 Docker Exec 命令进入 DB2 容器，并使用 MySQL 命令行工具连接到数据库。如果连接成功，则表明 PHPMyAdmin 的配置或网络配置存在问题。

5. 其他可能的解决方案

• 重新启动 Docker Desktop。
• 重新创建 DB2 容器。
• 更新 Docker Desktop 到最新版本。

结论

通过遵循这些步骤，您可以排除导致“连接被拒绝”错误的潜在原因，并恢复对 DB2 实例的访问。记住，解决问题需要细致的分析和对 Docker 环境的深入了解。

常见问题解答

1. 为什么我只能连接到一个 MySQL 实例，而不能连接到其他实例？

   • 可能的原因是网络配置或端口映射不正确，导致某些实例不可访问。

2. 我已检查了所有设置，但仍然无法连接。

   • 请尝试重新启动 Docker Desktop 和 MySQL 容器，或尝试更新 Docker Desktop 到最新版本。

3. 我正在使用 Docker Compose，如何检查网络配置？

   • 检查 Docker Compose YAML 文件中的 networks 部分，确保网络配置正确。

4. 如何重置 PHPMyAdmin 配置？

   • 删除 config.inc.php 文件，PHPMyAdmin 将重新创建它，并使用默认设置。

5. 为什么我使用 MySQL 命令行工具可以连接到数据库，但 PHPMyAdmin 不能？

   • 这表明 PHPMyAdmin 的配置或网络配置存在问题，而不是 MySQL 实例的问题。