Yii2中用ActiveDataProvider分页最稳妥：它自动处理LIMIT/OFFSET、排序过滤及总条数统计；需显式设pageSize、用LinkPager保持筛选状态、大数据量可设totalCount=false提升性能。
Yii2 中用 ActiveDataProvider 做分页查询最稳妥
直接用 ActiveDataProvider 是 Yii2 官方推荐、也是最省心的分页方式。它自动处理 SQL 的 LIMIT 和 OFFSET，还内置排序、过滤、总条数统计——不用手动写 COUNT(*)，也不用自己解析 $_GET['page']。
常见错误是绕过 ActiveDataProvider，直接用 Query + 手算偏移量，结果在数据动态增删时页码错乱、最后一页空或重复。
- 控制器里实例化时传入
query和pagination配置即可，pageSize建议显式指定（默认 20） -
pagination中的pageSizeParam和pageParam可自定义 GET 参数名，比如改成'per-page'或'p' - 如果模型字段有 JOIN 关联表，记得在
query中用distinct，否则count()可能重复计数
$query = Article::find()->where(['status' => 1]);
$dataProvider = new ActiveDataProvider([
'query' => $query,
'pagination' => [
'pageSize' => 15,
'pageParam' => 'p',
],
'sort' => ['defaultOrder' => ['created_at' => SORT_DESC]],
]);
分页链接生成必须用 LinkPager，别手拼 URL
手动拼 ?page=2&per-page=15 看似简单，但漏掉当前排序参数、过滤条件后，翻页就丢筛选状态。Yii 的 LinkPager 会自动保留全部 GET 参数（除分页相关键），这是它不可替代的地方。
典型坑是把 LinkPager 放在 ListView 或 GridView 外面单独渲染，结果样式错位、JS 事件不触发；或者没配 firstPageLabel/lastPageLabel，导致首页/末页按钮文字是数字“1”和“100”，体验割裂。
-
LinkPager必须和ActiveDataProvider绑定同一份dataProvider实例 - 若需 AJAX 分页，加
'options' => ['data-pjax' => 1]并确保容器有pjax包裹 - 移动端慎用
maxButtonCount设太小（如 3），容易让用户找不到下一页
<?= LinkPager::widget([
'pagination' => $dataProvider->pagination,
'firstPageLabel' => '首页',
'lastPageLabel' => '末页',
'maxButtonCount' => 5,
]) ?>
大数据量下 totalCount 变慢？关掉或换 COUNT 优化
当表超百万行，ActiveDataProvider 默认的 COUNT(*) 会变慢，甚至拖垮整个接口。这不是 Yii 的 bug，是 MySQL 对大表 COUNT 的固有限制。
别急着换 ElasticSearch，先看是否真需要精确总数：后台列表常要，前台商品列表往往“下一页还有”就够了。Yii 允许把 totalCount 设为 false，此时分页控件只显示“上一页/下一页”，不显示总页数和跳转框。
- 设
'totalCount' => false后，LinkPager自动降级为简单翻页，性能提升明显 - 若仍需总数，可改用近似值：
SELECT TABLE_ROWS FROM information_schema.TABLES（需权限，且非实时） - 更稳的法子是加覆盖索引，让
COUNT(*)走索引而非全表扫描，例如KEY idx_status_created (status, created_at)
自定义分页参数名时，Request 和 Pagination 要同步
想把 ?page=2 改成 ?p=2 很常见，但只改 Pagination::pageParam 不够——Request 组件默认还是从 page 键读，结果永远是第一页。
根本原因是 ActiveDataProvider 内部用 Yii::$app->request->get($pagination->pageParam) 拿当前页码，所以 pageParam 和实际 URL 键必须一致，且不能被其他中间件覆盖。
- 检查是否在
urlManager规则里用了'page'作为固定路由参数，和分页冲突 - 调试时直接 dump
Yii::$app->request->get()，确认目标参数名是否存在、类型是否为整数 - 若项目用了多语言路由（如
/zh-CN/list?p=2），确保urlManager的suffix和enablePrettyUrl配置不影响参数解析
分页看着简单，但参数传递链路长（URL → Request → Pagination → Query → DB），任一环断开就会静默失效。建议上线前用 Postman 模拟各种参数组合测一遍，尤其注意空参数、负数、超大页码这些边界值。
