yii分页最稳妥方式是activedataprovider，需传未执行query、显式写排序、linkpager配params透传参数、api响应加_meta字段返回totalcount，并优化count(*)性能。
Yii 框架分页最稳妥、最常用的方式是用 ActiveDataProvider，它自动处理查询、排序、LIMIT/OFFSET 和总数统计，不用手算页码或手动切数组。其他方式（比如 CPagination + 手动 findAll()）容易漏参数、多查一次、丢排序或翻页链接失效——尤其在带搜索或 URL 美化场景下。
ActiveDataProvider 怎么初始化才不丢总数和排序
ActiveDataProvider 必须接收一个未执行的 Query 或 ActiveQuery 实例，不能传 all() 结果或已调用 count() 的对象。否则会触发两次查询（一次 count，一次数据），且排序字段若没固化，翻页时顺序可能错乱。
- 正确写法：
$query = Article::find()->where(['status' => 1])->orderBy('created_at DESC');→ 再传给ActiveDataProvider - 错误写法：
$models = $query->all(); $provider = new ActiveDataProvider(['data' => $models]);—— 这就彻底绕过了 SQL 层分页，变成内存分页，大数据量直接 OOM - 排序必须显式写进
Query，不能靠 GridView 或 ListView 的 sort 配置来补；否则第 2 页可能混入第 1 页的数据
LinkPager 链接为什么丢了 category、tag 等参数
LinkPager 默认只保留 page 和 per-page 这两个键，其余 $_GET 参数全被过滤掉——这是 Yii2 的设计行为，不是 bug。比如当前 URL 是 /post/index?category=5&tag=php，点击“下一页”后变成 /post/index?page=2，category 和 tag 全没了。
- 修复方式：在
LinkPager::widget()的'pagination'配置里加'params'键，例如：'params' => ['category' => Yii::$app->request->get('category'), 'tag' => Yii::$app->request->get('tag')] - 更安全的做法是只透传必要参数，别直接写
'params' => $_GET，否则可能把_csrf或调试参数也带进去 - 如果启用了
urlManager路由美化，'route'必须显式指定，如'route' => 'post/index'，否则生成的链接可能路由错误
API 分页响应里怎么塞 totalCount 和 pageCount
Yii2 的 ActiveController 默认只返回当前页数据（$provider->getModels()），_meta 字段要自己加。前端做分页控件没总条数根本没法算页码数或禁用“下一页”按钮。
- 重写控制器的
serializeData()方法，在父类返回结果上追加：'_meta' => ['totalCount' => $provider->totalCount, 'pageCount' => $provider->getPagination()->getPageCount()] - 注意：
$provider->totalCount是惰性计算的，首次访问才查一次 DB；如果控制器里提前写了$provider->getTotalCount()，会多一次查询 - 不要在
beforeAction或behaviors()里试图统一注入，serializeData()是唯一可控且语义正确的入口
大表分页怎么避免 COUNT(*) 慢查询
当 WHERE 条件含函数、LIKE '%xxx' 或低选择性字段时，COUNT(*) 可能扫全表，响应从 50ms 涨到 2s+。ActiveDataProvider 默认就会触发这个查询，且无法跳过。
- 优先检查索引：确保
WHERE字段有有效索引，ORDER BY字段最好也覆盖在联合索引里 - 限制可翻页深度：在
pagination配置中加'maxPage' => 1000，超出后getPageCount()返回1000，前端自然停在第 1000 页 - 缓存总数：对变化不频繁的列表（如文章归档），用
yii\caching\Cache缓存totalCount5–10 分钟，命中缓存就跳过 COUNT - 真超大表（亿级）慎用手动分页逻辑，考虑游标分页（cursor-based pagination），但 Yii2 原生不支持，需自定义 Query + 上一页 last_id 传递
分页看似简单，实际最常出问题的是参数透传和总数计算时机——前者导致翻页后筛选条件丢失，后者拖垮接口性能。别图省事提前 all() 或硬塞 $_GET，该配 params 就配，该加索引就加。
