ThinkPHP模型查询无法通过模型定义实现动态默认排序，必须在查询时用order()动态传参，配合白名单校验用户偏好字段与方向，并确保order()在paginate()之前调用。
ThinkPHP 模型查询时如何动态设置默认排序字段
直接说结论：不能靠模型定义写死，得在查询时用 order() 动态传参，配合用户偏好缓存或请求参数做判断。
ThinkPHP 的模型本身不支持“运行时自动读取用户偏好并应用排序”，所谓“动态默认排序”本质是把排序逻辑从控制器或服务层前置到查询构建阶段，而不是改模型类的静态属性。
常见错误是试图在模型的 initialize() 或 boot() 里调用 order()——这无效，因为模型初始化时还没进查询流程；也有人往 $this->defaultOrder 这类自定义属性里塞值，但框架根本不会读它。
- 真正生效的位置只有：查询链式调用中（如
UserModel::where(...)->order(...)->select()），或通过scope封装后显式调用 - 推荐把排序逻辑抽成一个公共方法，比如
applyUserOrder($query)，接收查询对象并返回处理后的实例 - 注意
order()第二个参数是排序方向，别漏掉'asc'或'desc'，否则默认是'asc'，容易和用户预期不符
如何安全读取并校验用户偏好的排序字段
用户传来的 sort_field 和 sort_type 必须白名单校验，否则直接拼进 order() 就是 SQL 注入风险。
立即学习“PHP免费学习笔记（深入）”；
ThinkPHP 不会自动过滤 order() 参数，哪怕你传的是字符串字段名，只要没走预处理，就可能被绕过。比如用户传 id, (SELECT password FROM tp_user WHERE id=1)，某些旧版本会执行。
- 只允许的字段应硬编码在配置或常量里，例如
['id', 'create_time', 'username', 'status']，用in_array()判断 - 排序方向限定为
'asc'或'desc'，其他值一律 fallback 到默认（如'id desc'） - 别图省事用
request()->param('sort_field')直接透传，必须经过校验再进order()
用 Query Scope 实现可复用的排序逻辑
把排序封装成 scope 最干净，避免每个控制器都重复写校验 + order()，也方便测试和后期调整。
在模型里加一个 scopeUserOrder 方法，它接收两个参数：查询对象和用户偏好数组。这个方法不返回数据，只修改查询对象本身。
public function scopeUserOrder(Query $query, array $preference = []): void
{
$field = $preference['field'] ?? 'id';
$type = in_array($preference['type'], ['asc', 'desc']) ? $preference['type'] : 'desc';
$allowed = ['id', 'username', 'create_time'];
$field = in_array($field, $allowed) ? $field : 'id';
$query->order($field, $type);
}
调用时就是 UserModel::scopeUserOrder(['field' => 'username', 'type' => 'asc'])->select()。注意 scope 方法名必须以 scope 开头，且第一个参数固定是 Query 对象。
- scope 是静态调用，所以不能访问
$this，所有依赖要通过参数传入 - 如果偏好存在 session 或 Redis 里，建议在调用前统一读取、校验，再传给 scope，不要在 scope 内部读 session —— 耦合太重，单元测试难写
分页场景下 order() 放错位置会导致结果错乱
最常踩的坑：在 paginate() 之后再调用 order()，比如 UserModel::paginate(10)->order('id', 'desc') —— 这完全无效，paginate() 返回的是 Collection 或分页对象，不是查询构造器。
正确顺序永远是：先 order()，再 paginate()。如果你用的是闭包方式传参，也要确保 order() 在 paginate() 前触发。
- 错误示范：
UserModel::where(...)->paginate(10)->order(...) - 正确写法：
UserModel::where(...)->order('create_time', 'desc')->paginate(10) - 如果用了 scope，也必须在
paginate()前调用，UserModel::scopeUserOrder($pref)->paginate(10)
字段名拼错、方向写反、order 放在 paginate 后面——这三个问题占了线上排序异常的 80% 以上。调试时先盯住这三处，比查模型定义快得多。
