必须为分页查询绑定稳定排序：第一步确认主键或唯一索引字段可用；第二步orderBy()须在limit()/offset()之前调用；第三步组合排序防冲突；ActiveDataProvider中defaultOrder需配索引字段，禁用排序则设sort=>false；手写分页时count()后须clone查询对象再执行分页查询。
在Yii中实现模型查询分页时，若未显式指定排序字段或排序值不稳定（如使用无索引字段、NULL值混杂、浮点精度差异），会导致同一页数据反复刷新后顺序错乱、重复或遗漏——这是线上分页接口最常被投诉的问题。
必须为分页查询绑定稳定排序
第一步：确认主键或唯一索引字段可用。例如 User 表的 【id】 是自增主键，天然满足稳定性要求；若用 created_at，需确保该字段有 B-TREE 索引且无 NULL 值，否则 MySQL 可能返回非确定性顺序。
第二步：在 Active Record 查询中强制添加 orderBy()，且必须放在 limit() 和 offset() 之前。错误写法：->limit(10)->offset(20)->orderBy(['id' => SORT_ASC]) —— 此时排序发生在截断之后，已丢失原始全量顺序。
第三步：组合排序防冲突。当主键可能重复（如软删除场景下 id 不连续）或业务要求按时间+ID 二次排序时，写成：->orderBy(['status' => SORT_ASC, 'updated_at' => SORT_DESC, 'id' => SORT_ASC])。这样即使 updated_at 相同，也能靠 id 锚定唯一顺序。
ActiveDataProvider 分页配置要点
方法一：直接传 Query 对象并启用内置排序
$provider = new ActiveDataProvider([
'query' => User::find()->where(['status' => 1]),
'pagination' => ['pageSize' => 15],
'sort' => [
'defaultOrder' => ['id' => SORT_DESC],
'attributes' => ['id', 'username', 'created_at'],
],
]);
注意：此处 'attributes' 列表只控制哪些字段允许被前端点击排序，【不填 defaultOrder 或填了但字段无索引，仍会触发不稳定排序】。
方法二：禁用用户自定义排序，强制固定顺序
把 'sort' => false 即可关闭所有排序交互，此时 provider 内部仅依赖 query 自带的 orderBy()。适合后台只读列表，避免用户误点导致分页错乱。
手写分页时 count() 与 query 复用陷阱
先调 $query->count() 获取总数，再对同一 $query 调 ->offset()->limit()->all() —— 这是常见错误。因为 Yii 的 Query 对象是可变的，count() 会清空 orderBy、select 等部分状态，导致后续查询无序。
正确做法是克隆查询对象：
$countQuery = clone $query;
$totalCount = $countQuery->count();
$models = $query->orderBy(['id' => SORT_ASC])->offset($offset)->limit($limit)->all();
这一步不可省略。不 clone 就直接复用，【分页结果将完全不可预测】。
