thinkphp 默认连接会触发tdsql-c serverless暂停，因其默认在请求结束后关闭连接，若间隔超自动暂停阈值（默认1小时），计算资源被回收，再连接即报connection refused；根本原因是serverless依据“无连接且无cpu使用”判定暂停，与长连接无关。
ThinkPHP 连接 TDSQL-C Serverless 时，**不能依赖长连接保活来规避自动暂停**，因为 Serverless 的暂停是底层计算资源回收行为，与 PHP 进程或 MySQL 连接池无关；必须通过业务层控制连接时机 + 合理配置自动暂停阈值，否则会出现 SQLSTATE[HY000] [2002] Connection refused 或 MySQL server has gone away 类错误。
为什么 ThinkPHP 默认连接会触发 Serverless 暂停？
TDSQL-C Serverless 的自动暂停判定依据是「无连接且无 CPU 使用」，而 ThinkPHP 的默认数据库配置（如 'break_reconnect' => false）在单次请求结束后会关闭连接，若后续请求间隔超过设定的自动暂停时间（默认 1 小时），计算节点已释放，再发起连接就会失败。
常见表现：
- 首屏加载正常，但隔一段时间再刷新页面报错
Connection refused - 定时任务脚本执行一次成功，第二次失败
- 日志中出现
mysqli_real_connect(): (HY000/2002): Connection refused
根本原因不是网络问题，而是 Serverless 实例已进入暂停状态，需等待秒级唤醒 —— 但唤醒过程对客户端不可见，PHP 会直接报连接拒绝。
如何配置 ThinkPHP 适配自动启停？
核心思路：让连接行为尽量贴近「按需唤醒」，避免空等、不强求长连接。
- 关闭连接复用：
'deploy' => 0（单服务器模式），并确保'persistent' => false，防止 PDO 尝试复用已失效的 socket - 禁用断线重连：
'break_reconnect' => false，因为重连逻辑无法处理「实例尚未唤醒」的状态，反而造成重复失败 - 连接超时设短些：
'params' => [\PDO::ATTR_TIMEOUT => 5]，避免卡在连接阶段太久 - 在关键入口（如控制器
initialize()）里显式调用Db::connect()，而不是等到首次查询才触发连接 —— 这样可提前暴露唤醒延迟，便于监控
示例配置片段（database.php）：
'mysql' => [
'type' => 'mysql',
'hostname' => 'xxx.tdsql-c.tencentcdb.com',
'database' => 'testdb',
'username' => 'root',
'password' => '***',
'hostport' => 6389,
'charset' => 'utf8mb4',
'deploy' => 0,
'persistent' => false,
'break_reconnect' => false,
'params' => [\PDO::ATTR_TIMEOUT => 5],
],
要不要在应用层加心跳或预连接？
不推荐。Serverless 的暂停机制不响应心跳包，TCP Keepalive 或 PDO::exec('SELECT 1') 在实例暂停后全部无效，只会增加失败日志和连接开销。
- 如果业务有固定低频访问（如每 15 分钟一次后台任务），可将自动暂停时间设为
10 分钟（注意：分钟仅支持 0/10/20/30/40/50），比任务间隔略短即可 - 如果访问完全不可预测（如个人工具类后台），建议关闭自动暂停，改用最小 CCU（如
0.25）持续运行，费用可控且稳定 - 绝对不要在
think-swoole或常驻进程里维护长连接 —— Serverless 实例暂停后，该连接永久失效，且无法被检测或清理
手动启停在 ThinkPHP 场景下怎么用？
手动启停只适合运维操作，不适合运行时干预。ThinkPHP 请求无法感知「当前实例是否已暂停」，所以不能在代码里调用 API 触发启动。
- 暂停操作只能在控制台点「暂停」，适用于明确知道接下来几小时无任何访问（如测试环境夜间停机）
- 启动操作同样只能在控制台点「启动」，启动后需等待约 3–5 秒才能接受连接，期间所有请求都会失败
- 没有 SDK 或 HTTP 接口供 ThinkPHP 自动调用启动 —— 腾讯云未开放该能力，也不建议封装成定时任务轮询启动
真正需要关注的是「暂停阈值」和「连接行为」这两个可控点，其余交给 Serverless 底层自动处理。复杂的地方在于：暂停判断是全链路的（接入层 + 计算层 + 监控服务），不是单纯看 TCP 连接数，所以不能靠传统数据库连接池那一套去套用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
