GraphQL Resolver中直接查数据库必然触发N+1问题，需用DataLoader统一聚合批量查询，将$context作为共享载体传递loader实例，并在batch callback中严格补全所有$keys对应结果。
GraphQL Resolver里直接查数据库必然触发N+1
Yii2默认的GraphQL resolver写法，如果对每个子对象都单独执行一次查询（比如查一堆User，再为每个User查其Profile），就会在一次请求中发出几十甚至上百条SQL。这不是Yii2或GraphQL的问题，而是没把批量加载逻辑从resolver里抽出来。
关键不是“能不能用DataLoader”，而是“不引入DataLoader时，你写的resolver本质上就是在手写N+1”。
- 典型错误现象：
SELECT * FROM user执行1次，紧接着SELECT * FROM profile WHERE user_id = ?执行N次 - 使用场景：一对多（如订单→商品）、多对一（如文章→作者）、关联字段非空判断后还要取详情
- Yii2里容易忽略一点：
ActiveRecord::with()在GraphQL resolver中基本无效——因为resolver是逐个调用的，不是批量构建Query上下文
用PHP DataLoader库绕过Yii2原生限制
官方webonyx/graphql-php不带DataLoader，得自己集成。Yii2没有内置适配层，所以必须手动在Schema构建阶段注入DataLoader实例，并确保它能在所有resolver间共享（比如挂到$context上）。
别试图魔改ActiveRecord或重写resolve方法来“模拟”批处理——那只会让逻辑更难测、更难维护。
- 推荐用
overblog/dataloader-php，它支持Promise式批处理，和GraphQL PHP兼容性好 - 必须在每次GraphQL请求开始时新建一个
DataLoader实例（不能复用全局单例），否则并发请求会互相污染缓存 - batch callback里要统一用
ActiveRecord::find()->where(['id' => $keys])->indexBy('id')->all()，返回数组且key必须严格对应$keys顺序 - 示例片段：
$userLoader = new DataLoader(function (array $ids) { return User::find() ->where(['id' => $ids]) ->indexBy('id') ->all(); });
resolver里怎么安全调用DataLoader
直接在resolver函数里new DataLoader是错的——每个字段解析都会新建loader，失去批处理意义。正确做法是把loader提前塞进$context，resolver只负责load()。
很多人卡在这步：以为只要用了DataLoader就自动优化，结果发现SQL还是N+1。其实只是loader没传进去，或者传的是不同实例。
- 构建schema时，在
GraphQL::executeQuery()的第三个参数$context里挂loader：['userLoader' => $userLoader] - resolver里这么写：
$context['userLoader']->load($source->author_id)，不是loadMany——DataLoader自己会合并同一轮里的所有load()调用 - 注意
$source是父级对象（比如Post实例），字段resolver拿不到整个列表，所以load()只能传单个ID；批量逻辑完全由DataLoader内部聚合完成 - 如果resolver返回的是Promise（比如用
async），必须确保DataLoader的batch callback也返回Promise，否则GraphQL会等超时
关联字段为空时DataLoader会报错？
不会自动报错，但容易漏掉null值处理，导致PHP Warning或GraphQL返回null而前端无法区分“查无此记录”和“字段本应为空”。
DataLoader的batch callback返回的数组，key必须和输入$keys完全一致，缺失的key会导致load()返回Promise永远pending——GraphQL就卡住不动了。
- batch callback里务必补全所有
$keys，未查到的用null占位：$result[$id] = $models[$id] ?? null; - resolver里不要对
load()结果做isset()或empty()判断——它返回的是Promise，要用then()链式取值，或等GraphQL引擎自动await - Yii2的
ActiveRecord在indexBy('id')后，查不到的ID不会出现在数组里，这点特别容易踩坑，必须手动补全 - 调试技巧：在batch callback开头
var_dump($keys)，确认传入ID列表是否符合预期；再dump返回数组的array_keys()，看是否一一对应
事情说清了就结束。DataLoader本身不难，难的是在Yii2这种强ORM框架里，得亲手把数据加载逻辑从ActiveRecord的舒适区里拽出来，再稳稳接进GraphQL的异步流里。漏掉一次null占位，或loader挂错地方，整条查询链就退化回N+1。
