ThinkPHP如何配置修改数据库懒连接属性_优化数据库连接数-ThinkPHP-PHP中文网

必须在数据库配置顶层设 'lazy' => false 关闭懒连接，否则高并发下连接延迟集中导致阻塞；多库配置需逐个设置，且需同步调大 mysql max_connections 并合理配置 php-fpm 子进程数。

thinkphp如何配置修改数据库懒连接属性_优化数据库连接数

ThinkPHP 默认开启数据库懒连接，但生产环境高并发下容易因连接池耗尽导致请求阻塞——必须显式关闭或调整连接复用策略。

如何关闭 `lazy` 懒连接（TP6+）

懒连接本质是「首次查询时才建立连接」，看似省资源，实则在并发场景下把连接延迟集中到执行时刻，加剧连接竞争。TP6.1+ 中需在数据库配置中显式禁用：

'lazy' => false 是关键开关，不写默认为 true
该配置必须放在数据库连接配置数组顶层，不能嵌套在 params 或 attributes 里
若使用多应用或多个数据库配置，每个 database.php 配置项都要单独设置

示例片段（config/database.php）：

btpanel phpsite 宝塔面板PHP网站

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

下载

'default' => [
    'type'            => 'mysql',
    'hostname'        => '127.0.0.1',
    'database'        => 'test',
    'lazy'            => false, // ← 必须加这行
    'break_reconnect' => true,
],

`break_reconnect` 和 `deploy` 的联动影响

关闭懒连接后，连接失败行为由 break_reconnect 控制；但它和 deploy（读写分离）共存时容易误判重连逻辑：

break_reconnect => true 表示连接失败立即抛异常，适合强一致性场景
deploy => 1 且 lazy => false 时，TP 会在初始化阶段尝试连接主库+所有从库，任一失败即报错 —— 这不是 bug，是设计使然
若从库临时不可用又不想启动失败，应设 break_reconnect => false，但需自行处理后续查询的异常分支

连接数瓶颈不在 PHP 层，而在 MySQL `max_connections`

ThinkPHP 自身不维护连接池，每次请求都走 PDO 新建/复用连接（取决于 PDO::ATTR_PERSISTENT），所以「优化连接数」本质是协调 PHP 与 MySQL 的配置节奏：

确认 MySQL 实际允许的最大连接数：SHOW VARIABLES LIKE 'max_connections';
PHP-FPM 的 pm.max_children 建议 ≤ MySQL max_connections 的 70%，留余量给后台任务和 root 连接
TP 中不要盲目开 PDO::ATTR_PERSISTENT（持久连接），它在 FPM 下反而易引发连接泄漏和状态污染

真正卡住的往往不是配置写没写对，而是改完 lazy => false 后没同步调大 MySQL 的连接上限，或者没意识到读写分离模式下初始化就会连多个库 —— 这些地方一漏，压测时连接拒绝就来得特别突然。