在 ThinkPHP 5.1 中解决 N+1 查询问题，核心是在查询构建阶段使用 with() 方法声明关联，确保在主表查询执行前完成预加载配置，避免在循环中触发关联查询。

核心原理

N+1 查询是指先查主表 1 次，再对每条记录单独发起 1 次关联查询。ThinkPHP 默认支持延迟加载，如果在循环中访问关联属性，框架会为每条数据单独发送 SQL。预加载通过一次额外的 JOIN 或 IN 查询，将主模型与关联模型的数据一次性获取，把 N+1 次查询压缩为最多 2 次。

实操步骤

1. 定义模型关联

在模型文件中编写关联方法，返回 hasOne 或 hasMany 对象。确保方法名与后续 with() 调用一致。

<?php
namespace app\index\model;
use think\Model;

class User extends Model
{
    // 定义一对一关联
    public function profile()
    {
        return $this->hasOne('Profile');
    }

    // 定义一对多关联
    public function posts()
    {
        return $this->hasMany('Post');
    }
}

2. 修改查询语句

在控制器中，修改查询逻辑，将关联预加载放在 select() 之前。

// 错误：查出后再访问关联，触发 N+1
$users = User::select();
foreach ($users as $user) {
    echo $user->profile->name;
}

// 正确：查询前预加载，SQL 次数固定
$users = User::with('profile')->select();
foreach ($users as $user) {
    echo $user->profile->name;
}

3. 处理嵌套关联

如需加载多层关系，使用点号字符串写法。TP5.1 对深层嵌套支持有限，建议控制在三级以内。

// 推荐写法
$users = User::with('profile.posts')->select();

// 或者数组写法
$users = User::with(['profile', 'profile.posts'])->select();

验证方法

开启 ThinkPHP 的 SQL 日志功能，观察页面加载时的 SQL 执行记录。优化前会看到大量相似的 SELECT 语句针对关联表；优化后，关联表的查询应合并为 1 条语句，总查询次数显著减少。

开启 SQL 日志配置

修改 config/database.php 配置文件，设置 app_trace 为 true，或在 .env 中配置。

// config/database.php
return [
    // 其他配置...
    'app_trace' => true, // 开启 SQL 日志
];

开启后，页面底部或日志文件中会显示当前请求执行的所有 SQL 语句及执行时间。

常见坑

• with 位置错误：放在 select() 之后调用无法触发预加载，因为查询已执行。
• 关联方法名不一致：with() 中的字符串必须对应模型中真实的关联方法名。
• 嵌套层级限制：TP5.1 对深层嵌套支持不如新版本，三级以上关联可能静默失败，建议分步查询。
• load() 滥用：在批量循环中使用 load() 依然会导致 N+1，它适合单条实例的按需加载。