ThinkPHP 中 100 条用户数据配合无限制的 with() 关联查询会触发 200+ 次额外数据库请求，而通过预加载优化可将查询次数从 1+N 压缩至最多 2 次。

原因分析

N+1 问题的本质是框架在遍历主模型集合时，对每条记录单独发起关联查询。以 ThinkPHP 为例，查询 100 条用户记录后再访问每个用户的订单数据，实际会执行 1 次主查询 + 100 次关联查询 = 101 次 SQL。根据 2026 年 3 月 23 日发布的优化技巧汇总，即使只查 10 行数据，若 where 条件字段（如 user_id、status、created_at）未建索引，全表扫描也可能耗时 800ms。当表数据量达到 500 万行时，分页默认的 COUNT(*) 操作可能单独消耗 3 秒以上，这还未计入关联查询的开销。

解决方案：使用 with() 预加载限制关联数量

最直接的优化是在 with() 方法中通过闭包约束关联查询。示例代码：User::with(['orders' => function ($query) { $query->limit(5); }])->select()。根据 2026 年 4 月 16 日的实践记录，这种方式可避免全量拉取关联数据。同时需明确指定字段，如 with(['profile' => function ($q) { $q->field('user_id,nickname,avatar'); }])，防止 SELECT * 造成冗余数据传输。

解决方案：分离 count 逻辑避免分页性能崩塌

ThinkPHP 分页时默认先执行 COUNT(*)，但带 with() 的查询可能导致 COUNT 被错误推到 JOIN 后执行。修复方法来自 2026 年 4 月 16 日的验证记录：$list = User::with('orders')->where($cond)->paginate(['query' => request()->param(), 'count' => false]); $list->setTotal(User::where($cond)->count());。若关联表数据量大，建议缓存 count 值而非每次实时计算。

解决方案：慎用 join 替代 with 的场景

虽然原生 join() 能一步到位，但以下情况应禁用 join：关联表有软删除（delete_time 字段）时 with() 会自动过滤而手写 join 不会；使用了全局作用域（scope）或动态条件（如 whereTime('create_time', 'today')）时 join 无法继承这些规则；关联字段名不一致（如订单表外键叫 uid 而非 user_id）时 join 需手动对齐容易漏改。这些信息来自 2026 年 4 月 16 日的升级后性能调优实践。

注意事项：ThinkPHP 6.3+ withCount() 返回 null 问题

升级到 ThinkPHP 6.3+ 后，withCount() 对空关联返回 null 而非 0，这是 PDO 默认行为变更导致的。旧版返回 0，6.3+ 严格遵循 SQL COUNT 结果。解决方案来自 2026 年 4 月 16 日的记录：模板中统一用{$user.order_count ?: 0}替代{$user.order_count}，无需回滚版本。

注意事项：resultSetType 设为 collection 的分页陷阱

根据 2026 年 4 月 16 日的实践反馈，需确认模型定义里$resultSetType 没被设成'collection'，尤其在分页场景下，Collection 会触发多次 get() 导致性能下降。建议开启 SQL 日志（'show_sql' => true）查看分页的 COUNT 是否出现 JOIN 或 GROUP BY。

参考来源

来源：ThinkPHP 性能调优实践 - 模型关联数据查询优化_升级后的性能调优实践（2026 年 4 月 16 日）

来源：ThinkPHP 慢查询优化技巧汇总 - ThinkPHP 怎么优化查询性能（2026 年 3 月 23 日）

来源：ThinkPHP 关联预加载教程 - ThinkPHP 的关联预加载怎么用（2025 年 7 月 30 日）

来源：PHP 框架查询优化 - PHP 框架如何优化 SQL 查询_查询构造器高级用法教程（2026 年 3 月 9 日）