Yii 2中如何解决N+1查询问题？ActiveRecord是否有对应特性？

当然有啦！Yii的ActiveRecord里专门有对应Rails includes的特性——预加载（Eager Loading），通过with()方法就能轻松解决你遇到的N+1查询问题。

先明确前提：定义模型关联 #

首先得确保你的Person模型已经和Document模型建立了正确的关联关系，比如在Person.php里添加：

class Person extends ActiveRecord
{
    // ... 其他模型代码

    // 定义与Document的一对多关联
    public function getDocuments()
    {
        // 假设Document表用person_id关联Person的id字段
        return $this->hasMany(Document::class, ['person_id' => 'id']);
    }
}

问题根源：你的原始写法为什么会触发N+1查询 #

你之前用$model->findAll([...])然后在视图循环里调用$person->documents的写法，每次循环到一个Person实例时，Yii都会单独执行一条SQL去查询该用户对应的文档。假设你查出了100个人员，就会执行1次人员查询 + 100次文档查询，总共101次SQL请求，这就是典型的N+1问题。

优化方案：用with()预加载关联数据 #

Yii的with()方法和Rails的includes作用完全一致——它会先查询主模型（Person）的数据，然后一次性查询所有关联模型（Document）的数据，最后自动把关联数据和对应的主模型绑定，全程只需要2条SQL：

// 预加载所有Person对应的documents数据
$people = Person::find()->with('documents')->all();

之后你的视图代码可以完全保持不变：

<?php foreach( $people as $person ): ?>
    <li><?= $person->name ?></li>
    <li>
        <ul>
            <?php foreach( $person->documents as $document ): ?>
                <li><?= $document->number; ?></li>
            <?php endforeach; ?>
        </ul>
    </li>
<?php endforeach; ?>

这时候访问$person->documents只会从内存中读取预加载好的数据，不会再触发新的SQL查询，完美解决N+1问题。

进阶用法：让预加载更灵活 #

除了基础的预加载，with()还支持很多进阶操作：

• 嵌套预加载：如果Document还有关联模型（比如Author），可以一次性预加载多层关联：

  $people = Person::find()->with('documents.author')->all();
  

• 指定关联字段：如果只需要文档的部分字段，可以减少数据传输量：

  $people = Person::find()->with([
      'documents' => function ($query) {
          $query->select(['id', 'number', 'person_id']); // 只查需要的字段
      }
  ])->all();
  

• 过滤关联数据：只想加载特定条件的文档（比如已发布的）：

  $people = Person::find()->with([
      'documents' => function ($query) {
          $query->where(['status' => 'published']);
      }
  ])->all();
  

内容的提问来源于stack exchange，提问作者Paulo Teixeira