Yii2的with()预加载可解决N+1问题，但需确保关联在主查询阶段一次性获取：必须显式调用with()、避免循环中手动访问未预加载关系、GridView中需在search()里with并select关联字段，GraphQL场景应改用DataLoader批量聚合。
Yii2 的 with() 预加载本身就是为了**解决 N+1 问题**，但如果用法不当或场景复杂，反而会“看似用了 with，实则仍触发 N+1”。关键不在是否调用 with()，而在于**是否真正让关联数据在主查询中一次性获取**。
with() 为什么有时没生效？
常见误区：
-
只在模型定义里写了 getXXX() 关联方法，但查询时没显式调用
with()—— 这是纯延迟加载，每访问一次$model->relation就查一次库； -
用了
with('a.b.c')，但主查询结果被循环后又手动调用$item->a->b->c->name等深层属性 —— 若中间某层未 fully eager-loaded（比如 b 没有asArray()或没走 join），仍可能补查； -
在 GridView 或 foreach 中先取主模型，再对每个模型单独调用
->getRelation()->one()—— 这完全绕过了with()，等于回到原始 N+1。
真正有效的预加载写法
核心原则：**所有关联数据必须在主 Query 构建阶段就声明，并确保执行时是一次性 SQL（JOIN 或子查询）**。
- 简单多层：直接链式 with：
Customer::find()->with('orders.items.product')->all()； - 控制字段和条件：在 with 回调中定制：
->with(['orders' => function ($q) { $q->select(['id', 'customer_id', 'total'])->andWhere(['status' => 1]); }])； - 避免对象嵌套开销（尤其大数据量）：加
asArray()：Customer::find()->with('auth')->asArray()->all()； - 强制 JOIN 而非子查询（适合需 WHERE/GROUP/ORDER 关联字段的场景）：
->joinWith('auth', true, 'LEFT JOIN')—— 注意第二个参数true表示 eager load，且会把 auth 表字段带入主结果集。
Gridview 中展示关联字段的正确姿势
错误写法：'columns' => ['name', 'auth.source']（没提前 with，会触发 20 次 auth 查询）；
正确写法：
- 在 search() 方法的数据提供器中，主动 with：
$query->with(['auth'])； - 同时修改 select，把关联字段显式加入：
$query->select(['user.*', 'auth.source as auth_source'])； - GridView 列中改用别名：
'attribute' => 'auth_source', 'label' => '渠道来源'； - 搜索支持：在 search() 的
andFilterWhere中加['auth.source' => $this->auth_source]，并确保joinWith('auth')已启用。
GraphQL 场景下 with 失效怎么办？
GraphQL resolver 是逐字段调用的，with() 在单个模型实例上无效。此时必须换方案：
- 弃用 ActiveRecord 延迟访问，改用 DataLoader 批量聚合 ID；
- 每个 resolver 只返回 ID 列表，由 DataLoader 统一发起
Auth::find()->where(['uid' => $ids])->indexBy('uid')->all()； - 确保每次请求新建 DataLoader 实例，防止并发污染；
- 不拼 SQL、不重写 resolve，靠标准 Promise 批处理兜底。
