ThinkPHP6数据库连接慢主因是DNS解析或TCP握手超时；应将DB_HOST改为127.0.0.1或固定IP，DSN中添加connect_timeout=3（6.1+才生效），并配置skip-name-resolve=ON避免反向解析卡顿。
ThinkPHP6数据库连接慢，八成不是框架本身的问题，而是连接建立阶段卡在 DNS 解析、IPv6 尝试或 TCP 握手超时上。直接改 DB_HOST 为 127.0.0.1 或固定 IP，再加 connect_timeout=3 到 DSN，通常能从 5 秒降到 100ms 内。
为什么 localhost 会让 ThinkPHP6 连接卡住
Linux 下 localhost 默认触发 Unix Socket 连接，但某些 PHP 版本（尤其启用了 mysqlnd）或容器环境会 fallback 到 IPv6 的 ::1，而系统 DNS 配置未响应或 /etc/hosts 缺少映射时，就会卡在 DNS 查询 —— 默认等满 5 秒才退到 IPv4。这不是 ThinkPHP 慢，是底层 socket 在等。
实操建议：
- 把配置里的
'DB_HOST' => 'localhost'改成'DB_HOST' => '127.0.0.1'（本地直连）或真实内网 IP（远程库） - 确认 MySQL 服务监听的是
0.0.0.0:3306或127.0.0.1:3306，而不是仅127.0.0.1却被防火墙拦截 - 如果用 Docker，检查是否误配了
host.docker.internal且宿主机 DNS 不可达
DSN 加 connect_timeout=3 为什么有时没用
ThinkPHP6.1+ 才真正支持 DSN 中的 connect_timeout 参数；6.0 及更早版本用的是 PDO 封装层，它不透传该参数到底层 mysqlnd。你写了 mysql:host=192.168.1.100;connect_timeout=3，但 mysqlnd 根本不读这个值。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 先验证 PHP 是否真支持：写个脚本用
mysqli_init()+mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 3)测试连接是否秒断 - ThinkPHP6.0 用户，临时切到
'type' => 'mysqli'并手动传参，确认问题是否消失（不推荐长期用） - 升级到 6.1+ 后，在
database.php的 DSN 字符串里加;connect_timeout=3;read_timeout=3;write_timeout=3
持久连接（PDO::ATTR_PERSISTENT）在 FPM 下怎么用才不翻车
开启持久连接后，每个 PHP-FPM worker 进程会缓存一个连接，复用它处理后续请求。但若 MySQL 设置了 wait_timeout=60，而 worker 空闲超过 60 秒，下次复用就会报 MySQL server has gone away。
实操建议：
- 在数据库配置中显式启用：
PDO::ATTR_PERSISTENT => true，别只靠 .env 里的DB_PERSISTENT=true（TP6 默认不读这个） - 同步调大 MySQL 的
wait_timeout和interactive_timeout至 300 或更高 - 配合心跳检测：在模型基类的
initialize()里执行Db::query('SELECT 1')，低成本保活 - 避免在 CLI 或队列任务里用持久连接——它们生命周期长，容易积累脏连接
远程库 + 内网穿透场景下连接重置怎么办
现象是日志出现 Lost connection to MySQL server at 'reading initial communication packet'，不是网络不通，而是穿透网关（如 frp）把客户端真实 IP “污染”成了网关自身 IP，MySQL 开启了 skip-name-resolve=OFF（默认），试图反向解析这个 IP 域名，结果 DNS 超时卡死。
实操建议：
- MySQL 配置文件中强制加上
skip-name-resolve=ON，重启服务 - 检查 frp client 配置：确保
local_ip指向 MySQL 实际监听地址（比如127.0.0.1），且local_port与 MySQLbind_address一致 - 禁用 frp 的
proxy_protocol（除非 MySQL 明确支持并已配置） - 在穿透链路中间加一层 ProxySQL，它能做连接池 + 客户端 IP 透传，比硬扛更稳
最易被忽略的一点：所有这些优化都建立在“连接能建起来”的前提上。如果连 telnet 192.168.1.100 3306 都不通，优先查防火墙、内网穿透端口映射、MySQL bind_address，而不是调 PHP 配置。
