ThinkPHP多字段排序需防order被覆盖或NULL干扰，推荐字符串、数组、闭包三种写法；paginate会默认补order、全局scope强制重写、NULL值导致排序异常是三大翻车点。
ThinkPHP 设置多个排序条件，关键不在“怎么写”，而在“怎么不被覆盖、怎么不翻车”。最常出问题的不是语法错，而是 order 被 paginate 补默认值、被全局 scope 强制重写、或 NULL 值导致排序结果意外颠倒。
多字段排序的三种可靠写法
ThinkPHP 支持字符串、数组、闭包三种传参方式，但行为不同，选错容易埋坑：
-
字符串写法（推荐用于简单场景）：
$model->order('sort ASC, create_time DESC')—— 简洁直接，数据库原生执行，但无法控制 NULL 排序位置； -
数组写法（更安全，自动转义字段名）：
$model->order(['sort' => 'asc', 'create_time' => 'desc'])—— 避免字段名注入，适合字段名来自变量但已校验的场景； -
闭包或 Expression 写法（需精确控制 NULL 或自定义顺序）：
$model->orderRaw('sort IS NOT NULL, sort ASC, id DESC')或用Db::Expression实现如FIELD(status, 2,1,3)这类业务定制排序。
避免 order 失效的实操要点
很多情况下你写了 order 却没生效，大概率是被后续逻辑悄悄覆盖了：
- 调用
paginate()时，它会在没有显式 order 时自动补id ASC；只要你提前调过order()（哪怕空参），它就不再补，但也不会保留你的设置——因为底层是直接赋值$this->options['order'] = []； - 模型
initialize()或全局 scope 中写了$this->order('status DESC')，这个 order 不可被链式调用覆盖，必须用->order([])手动清空才能绕过； - 正确做法是：把排序逻辑收口到具体查询处，不要分散在模型初始化里；如必须用 scope，请改用条件式写法：
return $query->when($needSort, fn($q) => $q->order('xxx'))。
动态多条件排序的安全拼装
前端传排序参数（如 sort_field=price&sort_order=desc）时，绝不能直接拼进 SQL：
立即学习“PHP免费学习笔记（深入）”；
- 先定义白名单：
$allowedFields = ['price', 'created_at', 'name']; $allowedOrders = ['ASC', 'DESC']; - 校验参数：
$field = in_array($_GET['field'] ?? '', $allowedFields) ? $_GET['field'] : 'created_at';
$order = in_array(strtoupper($_GET['order'] ?? ''), $allowedOrders) ? $_GET['order'] : 'DESC'; - 拼接安全 order：
$query->order("`{$field}` {$order}");—— 字段名虽手动拼接，但因已白名单校验，无注入风险。
NULL 值影响排序？必须主动处理
MySQL 默认把 NULL 当最小值（ASC 时排最前），常导致“置顶”逻辑失效。想让 NULL 排最后，不能依赖数据库默认行为：
- 升序时把 NULL 排后面：
orderRaw('is_null(sort), sort ASC')； - 降序时把 NULL 排后面：
orderRaw('is_null(sort) DESC, sort DESC')； - 更清晰写法：
orderRaw('sort IS NULL, sort DESC')—— 先按是否为 NULL 排（false 在前），再按字段值排。
