如何排查Docker环境下phpMyAdmin突然无法登录MySQL的问题

算力阿峰

2026-8-17

排查phpMyAdmin间歇性无法连接MySQL容器的方向

以下是针对该问题的具体检查要点：

1. 验证phpMyAdmin的连接配置

检查phpMyAdmin容器的环境变量，确认PMA_HOST是否设置为MySQL容器的名称（如mysql）。故障出现时，在phpMyAdmin容器内执行ping mysql，查看是否存在DNS解析失败的情况：
```
docker exec -it myadmin ping mysql
```
若解析不稳定，可尝试将PMA_HOST改为MySQL容器的静态IP（通过docker inspect mysql获取），规避Docker内部DNS的潜在问题。
查看phpMyAdmin的配置文件config.inc.php（通常在容器内/etc/phpmyadmin/路径下），确认连接方式：
- 若使用Unix套接字，检查$cfg['Servers'][$i]['socket']的路径是否与MySQL容器内的套接字路径一致（MySQL默认是/var/run/mysqld/mysqld.sock），且是否通过卷挂载共享了该套接字；
- 若使用TCP连接，确认$cfg['Servers'][$i]['host']设置正确，没有被意外修改。

检查两个容器所在的Docker网络状态，执行：
```
docker network inspect <你的网络名称>
```
确认两个容器的IP地址、网络端点配置正常，没有出现IP冲突或网络断开的记录。
故障出现时，在phpMyAdmin容器内测试MySQL端口的连通性：
```
docker exec -it myadmin nc -zv mysql 3306
```
若连接失败，查看宿主的Docker服务日志，检查是否存在网络组件异常：
```
journalctl -u docker.service --since "1小时前"
```
检查宿主的iptables规则，确认没有间歇性拦截容器间的3306端口流量：
```
iptables -L -n | grep 3306
```

登录MySQL容器，查看当前连接数与最大连接数限制：
```
SHOW VARIABLES LIKE 'max_connections';
SHOW STATUS LIKE 'Threads_connected';
```
若Threads_connected接近max_connections，说明连接数耗尽，需调整max_connections参数或优化应用连接池。
检查MySQL的连接超时配置：
```
SHOW VARIABLES LIKE 'wait_timeout';
SHOW VARIABLES LIKE 'interactive_timeout';
```
若超时时间过短，MySQL会主动关闭闲置连接，而phpMyAdmin可能未正确处理重连逻辑，导致连接失败。
查看MySQL的错误日志（容器内路径/var/log/mysql/error.log，若挂载到宿主则查看对应路径），排查故障出现时是否有连接拒绝、资源不足等日志信息。

查看phpMyAdmin容器的运行日志，获取连接失败的详细报错：
```
docker logs myadmin --tail 100
```
重点关注PHP mysqli扩展的错误、连接池相关的异常信息。
检查phpMyAdmin版本，若使用旧版本，可能存在与MySQL 8.0的兼容性问题或连接重连机制的bug，尝试升级到最新稳定版：
```
docker pull phpmyadmin:latest
docker stop myadmin && docker rm myadmin
# 重新启动phpMyAdmin容器，保持原有配置
```
检查phpMyAdmin的连接复用配置，确认是否存在失效连接未被及时回收的情况，可尝试调整$cfg['Servers'][$i]['persistent']参数（设为false关闭持久连接）测试。

故障出现时，检查宿主的资源使用情况：
```
top
free -m
iostat -x 1 5
```
确认是否存在内存不足（OOM）、CPU过载或磁盘IO过高的情况，这些问题可能间接影响容器间的网络连接。
检查宿主磁盘空间，确保Docker存储目录（默认/var/lib/docker/）有足够空间：
```
df -h /var/lib/docker/
```
检查宿主的安全软件（如防火墙、SELinux），确认没有间歇性拦截容器间的网络流量。

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