来源：未知来源 | 发布日期：2026-07-14

MySQL 连接失败排查指南

核心思路： 先明确报错类型对应的层面（本地 socket / 网络层 / 认证层 / 资源层），再用对应命令逐层验证证据，避免在错误方向上反复尝试。

本文按"现象 → 信息收集 → 初步判断 → 命令检查 → 证据分析 → 根因 → 修复 → 验证 → 复盘"展开。命令基准为 MySQL 8.0（部分兼容 5.7）。

一、典型报错与对应层面

二、排查前必须收集的信息

• 客户端类型：本机 CLI 还是远程应用服务器？
• 连接方式：Unix Socket 还是 TCP（-h 指定 IP）？
• MySQL 版本：SELECT VERSION(); 或 mysqld --version
• 部署方式：物理机/虚拟机、Docker 容器、Kubernetes Pod？
• 完整错误码和错误信息
• 问题性质：全新环境从未连接成功，还是之前正常现在突然失败？

"从未连接成功" → 配置或权限问题；"之前正常现在失败" → 资源耗尽、网络变化、密码被修改。

三、本地 Socket 连接失败（错误 2002）

排查步骤

1. 检查服务状态：

systemctl status mysqld
# 或某些发行版服务名为 mysql
systemctl status mysql

2. 服务 running 但仍报 2002 → socket 路径不匹配：

# 查看配置中定义的 socket 路径
grep -i "^socket" /etc/my.cnf /etc/mysql/my.cnf /etc/mysql/mysql.conf.d/mysqld.cnf 2>/dev/null

# 确认文件是否存在
ls -l /var/run/mysqld/mysqld.sock

# 检查目录权限
ls -ld /var/run/mysqld/

3. 目录被删除（/var/run 是 tmpfs，重启清空）：

cat /usr/lib/tmpfiles.d/mysql.conf
# 应有：d /var/run/mysqld 0755 mysql mysql -

4. 手动指定 socket 验证：

mysql -u root -p --socket=/var/run/mysqld/mysqld.sock

四、网络层不可达（错误 2003）

关键判断依据

命令检查

1. 验证端口是否在监听：

ss -ltnp | grep 3306

• 监听 0.0.0.0:3306 → 正常
• 监听 127.0.0.1:3306 → 只监听回环，远程连不上（bind-address 问题）
• 无输出 → mysqld 没启动或启动后退出，查错误日志

2. 客户端侧验证 TCP 连通性：

telnet <MySQL服务器IP> 3306
# 或
nc -zv <MySQL服务器IP> 3306

3. 检查防火墙：

# firewalld
firewall-cmd --list-ports

# iptables
iptables -L -n | grep 3306

4. 查看 MySQL 错误日志：

tail -100 /var/log/mysqld.log
# Debian/Ubuntu
tail -100 /var/log/mysql/error.log

# 查日志路径
grep -i "log-error\|log_error" /etc/my.cnf /etc/mysql/mysql.conf.d/mysqld.cnf 2>/dev/null

Docker/K8s 场景额外检查

# Docker：确认容器状态和端口映射
docker ps --filter "name=mysql"
docker logs --tail 100 <容器名>

# K8s：确认 Pod、Service、NetworkPolicy
kubectl get pods -n <namespace> -l app=mysql
kubectl logs -n <namespace> <pod> --tail=100
kubectl get svc -n <namespace> mysql
kubectl get networkpolicy -n <namespace>

五、认证与权限问题

5.1 用户白名单限制（错误 1130）

SELECT user, host FROM mysql.user WHERE user = 'app_user';

如果客户端来源 IP 不在已授权的 host 范围内，需添加授权：

-- 创建用户时指定来源
CREATE USER 'app_user'@'192.168.1.%' IDENTIFIED BY 'password';
GRANT SELECT, INSERT ON db.* TO 'app_user'@'192.168.1.%';

5.2 密码认证失败（错误 1045）

排查步骤：

1. 确认密码正确性
2. 检查账号是否被锁定（MySQL 8.0.19+）：

SELECT user, host, account_locked, password_expired FROM mysql.user WHERE user = 'app_user';

1. 检查认证插件兼容性：

SELECT user, host, plugin FROM mysql.user WHERE user = 'app_user';

MySQL 8.0 默认 caching_sha2_password，老版本客户端驱动不支持会报握手异常。

修复锁定：

ALTER USER 'app_user'@'10.0.0.%' ACCOUNT UNLOCK;

修复认证插件兼容性（过渡方案）：

ALTER USER 'app_user'@'10.0.0.%' IDENTIFIED WITH mysql_native_password BY '原密码';

5.3 连接数耗尽（错误 1040）

SHOW VARIABLES LIKE 'max_connections';
SHOW STATUS LIKE 'Threads_connected';
SHOW STATUS LIKE 'Max_used_connections';

查看连接来源分布：

SELECT db, user, host, COUNT(*) AS cnt
FROM information_schema.processlist
GROUP BY db, user, host
ORDER BY cnt DESC LIMIT 10;

调大 max_connections 只是临时缓解，治本需排查应用端连接池配置和连接泄漏。

5.4 连接中途断开（错误 2013）

SHOW VARIABLES LIKE 'max_allowed_packet';
SHOW VARIABLES LIKE 'wait_timeout';
SHOW VARIABLES LIKE 'interactive_timeout';

根本修复：连接池启用连接有效性检测（如 testOnBorrow），而非一味调大 wait_timeout。

六、根因归纳表

七、修复与验证流程

1. 本机 socket 验证 — 排除网络因素
2. 客户端网段 telnet/nc — 确认网络层通
3. 实际账号登录验证：

mysql -h <MySQL服务器IP> -P 3306 -u app_user -p -e "SELECT 1;"

1. 权限验证 — 执行一次实际业务 SQL（不仅是 SELECT 1）
2. 持续观察 — 连接数、内存使用率

八、高风险操作原则

九、复盘与预防

• 新环境部署后做标准化连通性验证清单（本地 socket + 跨网段 TCP + 业务账号登录）
• bind-address、白名单、防火墙规则变更要记录文档
• 应用连接池配置与数据库端 max_connections/wait_timeout 匹配设计
• 部署连接数监控（mysqld_exporter → Prometheus）
• 账号锁定机制需配合来源 IP 分析，防拒绝服务攻击

关联页面