根本原因是DNS解析超时(5秒)叠加TCP连接超时(5秒)，导致卡顿；应改用IP地址、DSN加connect_timeout=3、启用deploy=>1并补全PDO超时参数，CLI/Swoole下须手动Db::close()。
跨地域数据库连接在 ThinkPHP 中无法靠“配个 host”就搞定，真实瓶颈是 DNS 解析 + TCP 连接超时叠加导致的 5–10 秒卡顿，优化核心不是调框架参数，而是绕过系统默认超时、改用 IP 直连、并控制连接建立时机。
为什么远程数据库连接总卡住 5–10 秒
ThinkPHP 本身不控制 socket 层连接超时，底层 PDO（尤其是 mysqlnd 驱动）会先等 DNS 解析 5 秒，再等 TCP connect 5 秒，两个 timeout 叠加，还没执行 SQL 就已 hang 住。现象是 SQLSTATE[HY000] [2002] Connection refused 报错延迟极高，或日志里出现 Lost connection to MySQL server at 'reading initial communication packet'。
- 域名解析失败时系统不会立即 fallback，而是静默等待超时
-
params => [\PDO::ATTR_TIMEOUT => 2]控制的是 SQL 执行超时，对建连无影响 - DSN 中写
connect_timeout=3在 mysqlnd 下基本无效（TP 6.1+ 才透传） - 内网穿透（如 frp）配置错位（比如 local_port 和 MySQL 实际监听地址不一致）也会表现为“连接慢”，实则是连接根本没通
database.php 中必须改掉的三项配置
别碰 persistent => true，它在 TP 里既不生效又容易引发状态污染；真正起效的是这三项：
- 把
'hostname' => 'db-prod-shanghai.example.com'改成固定 IP：'hostname' => '10.20.30.40'，彻底绕过 DNS - 在 DSN 中显式加
connect_timeout（TP 6.1+ 有效）：'dsn' => 'mysql:host=10.20.30.40;port=3307;dbname=test;connect_timeout=3;' - 补全
params中的 socket 超时（兼容旧版）：'params' => [\PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION, \PDO::ATTR_TIMEOUT => 2, \PDO::MYSQL_ATTR_CONNECT_TIMEOUT => 3]
deploy => 1 在异地多活下怎么用才不翻车
deploy => 1 不是连接池，只是同配置复用 PDO 实例。跨地域场景下极易因配置微小差异导致复用失效，变成“看似复用，实则每请求新建连接”。
立即学习“PHP免费学习笔记（深入）”；
- 主库和从库必须使用完全一致的
type、hostname、hostport、database、username、password—— 漏一个就会 fallback 到 default 配置，复用中断 - 异地从库若用不同账号（如只读账号），必须单独定义完整配置数组，不能只改
username后复用主库连接 -
rw_separate => true后，Db::table('user')->select()默认走从库；但Db::table('user')->where('id', 1)->find()仍可能走主库（取决于是否命中读写分离规则），不要依赖“自动” - 事务中所有操作强制走主库，
Db::transaction()内部不能混用Db::connect('slave_db')，否则连接隔离失效
CLI 和 Swoole 下连接泄漏的真实风险
FPM 请求结束自动关连接，但 CLI 命令和 Swoole 协程进程常驻内存，Db::table()->select() 执行完连接对象还在内存里，反复运行几次就触发 Too many connections。
- 每个 CLI 命令末尾必须显式调用
Db::close()，不能依赖“脚本结束自动释放” - Swoole 任务中，避免在
__construct或中间件里提前调Db::connect()；应在协程内用go(function () { ... })包裹查询逻辑 - 心跳配置必须同步服务端：
'options' => ['heartbeat' => 3]对应 MySQL 的SET GLOBAL wait_timeout = 300，否则空闲连接被 kill 后下次调用直接报错 - 别信“连接池”宣传——TP 自身无连接池，Swoole 场景下真要池化，得用
swoole\database\PDOPOOL或 think-swoole 的pool.db配置
异地多活最易被忽略的点：不是连接配不配得上，而是连接建不建得快、用不用得稳、断不断得准。IP 直连、DSN 显式超时、deploy 配置完整性、CLI/Swoole 下手动 close —— 四件事漏掉任一，都可能让“多活”变成“单点故障放大器”。
