ThinkPHP数据库配置实战：解决“SQLSTATE[HY000] [2013] Lost connection to MySQL server”的网络抖动优化-ThinkPHP-PHP中文网

sqlstate[hy000] [2013]错误本质是服务端在tcp连接已建立后、初始握手包交换前主动中断连接，主因是mysql启用dns反向解析（未配skip-name-resolve）、认证插件不兼容或bind-address限制，而非网络抖动；典型表现是本地命令行可连而php/pdo报错，且日志显示“aborted connection to db: 'unconnected'”。

thinkphp数据库配置实战：解决“sqlstate[hy000] [2013] lost connection to mysql server”的网络抖动优化

为什么`SQLSTATE[HY000] [2013]`不是网络抖动，而是配置错位

这个错误根本不是“网络抖动”导致的——它发生在 TCP 连接已建立、但 MySQL 还没来得及发回初始握手包时就被切断了。本质是服务端拒绝完成协商，常见于 DNS 解析卡住、认证插件不兼容、或连接参数触发了 MySQL 的早期拦截机制。

典型现象：本地 mysql -h 127.0.0.1 -u root -p 能连，PHP 用同样 host 却报 [2013] Lost connection to MySQL server at 'reading initial communication packet'；或者只在 Docker 容器里复现，宿主机完全正常。

MySQL 日志里往往没有完整连接记录，只有类似 Aborted connection ... to db: 'unconnected' user: 'root' host: '172.18.0.3' 的日志行
用 nc -zv 127.0.0.1 3306 能通，但 PDO 连接仍失败 → 排除端口不通，指向协议层或认证环节
错误末尾带 system error: 111（Connection refused）或 system error: 0（无具体原因）→ 前者大概率服务未监听该地址，后者更可能是 skip-name-resolve 缺失或 DNS 延迟超限

`skip-name-resolve` 必须加，且要加在 `[mysqld]` 段最开头

MySQL 默认会对每个新连接的 client IP 做反向 DNS 查询（gethostbyaddr），若 DNS 不可用、响应慢、或返回多个 hostname，就会在读取初始包阶段直接 abort 连接——这正是 [2013] 错误最常见的根因。

加了 skip-name-resolve 后，MySQL 直接跳过 DNS 查找，用 IP 地址做权限匹配，既提速又稳定。但它不是“可选优化”，而是生产环境必须项。

编辑 /etc/mysql/mysql.conf.d/mysqld.cnf 或 /etc/my.cnf，在 [mysqld] 段第一行插入：skip-name-resolve
重启服务：sudo systemctl restart mysql（Linux）或服务管理器中重启（Windows）
确认生效：mysql -u root -p -e "SHOW VARIABLES LIKE 'skip_name_resolve';" → 输出应为 ON
⚠️ 注意：加完后所有用户授权语句中的 host 必须用 IP（如 'root'@'127.0.0.1'），不能再用 'root'@'localhost' 或 'root'@'%'（除非你同时开了 bind-address = 0.0.0.0 并明确放行）

ThinkPHP 中 `DB_HOST` 写 `localhost` 就是自找麻烦

在 Linux/macOS 下，localhost 会让 PHP 的 PDO 强制走 Unix socket（而非 TCP），而多数 MySQL 配置默认不启用 socket 文件，或路径不对（如 phpEnv 用的是 /tmp/mysql.sock，但 mysqld 实际监听 /opt/homebrew/var/mysql/mysql.sock）。结果就是 PDO 尝试连一个根本不存在的 socket 路径，报出和 [2013] 极其相似的连接中断。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

解决方法非常简单：一律用 127.0.0.1，强制走 TCP/IP，绕过所有 socket 相关歧义。

.env 中写：DB_HOST=127.0.0.1，别写 localhost、127.0.0.1:3306 或带端口的完整地址（端口由 DB_PORT 控制）
Docker 环境下，DB_HOST 不能是 127.0.0.1（那是容器自己），得换成 MySQL 容器名（如 mysql）或 host.docker.internal（Docker Desktop 支持）
Mac M1 + Homebrew MySQL：检查 mysqld 是否启用了 bind-address = 127.0.0.1 且 skip-networking = OFF，否则即使写了 127.0.0.1 也会被拒绝

连接超时参数不是万能解药，但 `connect_timeout` 必须设

connect_timeout 是 MySQL 服务端参数，控制从 TCP 握手完成到收到第一个数据包之间的最大等待时间（单位秒）。默认值是 10 秒，在高延迟或 DNS 不稳的网络里极易触发 [2013]。但它只能缓解，不能替代 skip-name-resolve。

真正关键的是：这个参数必须设在服务端（my.cnf），而不是 PHP 的 DSN 里——PDO 不识别 connect_timeout 作为 DSN 参数。

在 [mysqld] 段添加：connect_timeout = 30（建议 20–60，勿设过大）
同时建议补上：wait_timeout = 28800 和 interactive_timeout = 28800（尤其队列场景防 2006 MySQL server has gone away）
改完务必重启 MySQL，然后验证：mysql -u root -p -e "SHOW VARIABLES LIKE '%timeout%';"
PHP 层无需额外设置，PDO 会自动适配服务端策略；但 ThinkPHP 队列任务若常驻内存，需配合 Db::connect() 按需重建连接，或改用 listen 模式（每次任务新建进程）

最容易被忽略的一点：MySQL 配置改了，但没重启服务，或改的是错误的配置文件（比如改了 /etc/my.cnf，实际加载的是 /etc/mysql/mysql.conf.d/mysqld.cnf）。运行 mysql --help | grep "Default options" 看加载顺序，再用 ps aux | grep mysqld 找出实际配置路径，比猜快得多。