在 Docker 容器中配置 MySQL 或其他服务时，出现连接超时问题通常与网络设置、Docker 容器的端口映射、防火墙配置等因素相关。下面是一些常见的排查步骤和解决方案，可以帮助你解决“连接超时”问题。

1. 检查 Docker 容器的网络配置

首先，确保容器内的 MySQL 服务已经正确运行并绑定了合适的端口。

1.1 检查容器的端口映射

确保你在启动容器时将 MySQL 的默认端口（通常是 3306）正确映射到了主机的端口。

例如，启动 MySQL 容器时使用如下命令：

docker run --name mysql-container -e MYSQL_ROOT_PASSWORD=my-secret-pw -p 3306:3306 -d mysql:8

这里，-p 3306:3306 是将容器的 3306 端口映射到主机的 3306 端口。如果没有正确映射，外部应用就无法连接到 MySQL 服务。

1.2 检查容器的 IP 地址

你可以通过以下命令查看容器的 IP 地址，并尝试直接连接到该 IP：

docker inspect mysql-container | grep "IPAddress"

然后，使用该 IP 地址进行连接，例如：

mysql -u root -h <container-ip> -p

如果能够通过容器的 IP 地址连接到 MySQL，说明网络连接没有问题，问题可能出在主机端口映射。

2. 检查防火墙设置

防火墙可能会阻止从外部连接到容器内的 MySQL 服务。你需要检查防火墙设置，确保 3306 端口是开放的。

2.1 在 Linux 上检查防火墙设置

使用 firewalld 或 iptables 检查防火墙规则。

  • 对于 firewalld，可以使用以下命令查看当前开放的端口：
sudo firewall-cmd --list-all
  • 如果 3306 端口没有开放，可以使用以下命令开放端口：
sudo firewall-cmd --zone=public --add-port=3306/tcp --permanent
sudo firewall-cmd --reload

2.2 检查 Docker 防火墙规则

Docker 默认会创建一些 iptables 规则，如果这些规则配置不当，也可能导致连接超时。你可以通过以下命令检查 Docker 的防火墙规则：

sudo iptables -L -n

查看是否有规则阻止了 3306 端口的访问。

3. 检查 MySQL 配置文件

MySQL 的配置文件（my.cnf）可能限制了连接的来源，特别是 bind-address 和 skip-networking 设置。

3.1 查看 MySQL 配置文件

进入 MySQL 容器并查看配置文件 /etc/mysql/my.cnf 或 /etc/my.cnf：

docker exec -it mysql-container cat /etc/mysql/my.cnf

查看 bind-address 是否设置为 0.0.0.0，这意味着 MySQL 将接受任何 IP 地址的连接。如果是 127.0.0.1 或 localhost，则 MySQL 只会接受本地连接。

bind-address = 0.0.0.0

3.2 检查是否启用了 skip-networking

如果 skip-networking 被启用，MySQL 将无法使用网络连接。确保没有启用它，或者注释掉：

#skip-networking

3.3 重启 MySQL 服务

修改配置后，记得重新启动 MySQL 服务：

docker restart mysql-container

4. 检查 Docker 网络模式

如果你使用了 Docker 的自定义网络模式（如 bridge、host 或 overlay），请确保容器在合适的网络模式下启动，并且该模式允许容器之间的通信。

4.1 使用 Docker 默认网络模式

如果你没有指定网络模式，Docker 会使用默认的 bridge 网络模式。你可以检查当前容器的网络模式：

docker inspect mysql-container | grep "NetworkMode"

默认情况下，容器会连接到 bridge 网络。如果你希望容器之间可以直接通信，可以考虑将容器连接到同一个自定义网络。

docker network create mynetwork
docker run --name mysql-container --network mynetwork -e MYSQL_ROOT_PASSWORD=my-secret-pw -p 3306:3306 -d mysql:8

然后，可以在同一网络中的其他容器中使用容器名称来连接 MySQL 服务：

mysql -u root -h mysql-container -p

4.2 使用 Host 网络模式

如果你使用 host 网络模式，容器将共享主机的网络堆栈。这意味着容器内的服务会绑定到主机的 IP 地址，而不需要进行端口映射。你可以通过以下方式启动 MySQL 容器：

docker run --name mysql-container --network host -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:8

这种方式可能避免了端口映射带来的问题。

5. 检查 MySQL 连接限制

MySQL 默认可能会限制最大连接数。你可以检查 MySQL 的连接限制，确保连接数没有超出最大值。

5.1 查看最大连接数

登录到 MySQL 并运行以下 SQL 查询来查看当前的最大连接数：

SHOW VARIABLES LIKE 'max_connections';

如果需要，可以调整 max_connections 值：

SET GLOBAL max_connections = 500;

5.2 查看连接用户的权限

确保 MySQL 用户有权限从远程连接。登录到 MySQL 并执行以下查询来检查用户权限：

SELECT host, user FROM mysql.user;

如果你的 MySQL 用户只允许从 localhost 连接，可以执行以下命令修改权限：

GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'my-secret-pw';
FLUSH PRIVILEGES;

6. 检查容器日志

检查容器日志以确定 MySQL 是否正常启动并侦听正确的端口：

docker logs mysql-container

如果有任何错误或异常，可以根据日志信息进一步排查。

7. 总结

如果你遇到连接超时的问题，可以按照以下步骤进行排查和解决：

  1. 确认 Docker 容器的端口映射是否正确。
  2. 检查防火墙设置，确保 3306 端口开放。
  3. 查看 MySQL 配置，确保 bind-address 设置为 0.0.0.0，并确保没有启用 skip-networking。
  4. 检查 Docker 网络设置，确保容器在正确的网络模式下启动。
  5. 确保 MySQL 用户有正确的权限，并且没有达到最大连接数限制。
  6. 查看容器日志，确保 MySQL 服务正常运行。

通过这些步骤，你应该能够找到并解决 Docker 容器中 MySQL 连接超时的问题。