先写的字段优先级更高，后写的只对前字段值相等的记录生效；重复调用同一字段会覆盖前次设置，动态排序宜用数组循环构建。
多个 orderBy 调用的执行顺序就是优先级顺序
在 Laravel Eloquent 中，orderBy 是链式调用，**先写的字段优先级更高，后写的字段只对前一个字段值相等的记录生效**。比如：User::orderBy('status')->orderBy('created_at', 'desc')->get() 表示：先按 status 升序排，status 相同的再按 created_at 降序排。
常见错误是误以为写成 orderBy('a')->orderBy('b')->orderBy('a', 'desc') 能实现“a 升序 + b 升序 + a 降序”的混合效果——实际上最后一次对 a 的设置会覆盖前一次，最终只有 b 和最后那个 a 生效。
- 多字段排序必须严格按逻辑层级从高到低书写
- 不要重复调用同一字段的
orderBy，否则前面的会被丢弃 - 动态拼接时建议用数组遍历：
foreach ($sorts as $field => $direction) { $query->orderBy($field, $direction); }
Elasticsearch 多字段 sort 数组顺序决定优先级
ES 的 sort 是 JSON 数组，**数组索引越小，排序优先级越高**。例如："sort": [{"status": {"order": "asc"}}, {"created_at": {"order": "desc"}}] 表示 status 相同时才比 created_at。
注意：ES 不支持在同一个 sort 条目里混用升/降序逻辑（比如“有标签则 created_at 升序，无标签则降序”），这种必须用 Painless 脚本计算出一个统一可比的数值或字符串作为排序键。
- 字段类型要匹配：date 字段需指定
format，否则可能解析失败或排序错乱 - 对
keyword多值字段排序，需显式加"mode": "min"或"max"，否则默认行为未定义 - 避免对未映射字段排序，应设
"unmapped_type"防止整个请求报错
Laravel 集合 sortBy 系列方法不支持字段名直传多级排序
sortBy('created_at') 看似方便，但底层是字符串比较，"2024-01-01" 会排在 "2023-12-31" 前面。它也不支持多字段，更无法嵌套条件逻辑。
真正需要多级或带判断的排序，必须用 sort() + 闭包 + 太空船操作符 。比如按状态权重分组、同组内按时间倒序：
->sort(function ($a, $b) {
$priority = ['active' => 3, 'pending' => 2, 'draft' => 1];
$aP = $priority[$a->status ?? 'draft'] ?? 0;
$bP = $priority[$b->status ?? 'draft'] ?? 0;
if ($aP !== $bP) return $bP $aP;
return ($b->updated_at?->timestamp ?? 0) ($a->updated_at?->timestamp ?? 0);
})
-
sortByDesc(fn($x) => $x->created_at?->timestamp)比sortByDesc('created_at')安全得多 -
sort()是就地修改，原集合键名丢失；若需保留，得先clone - 大数据量下，Collection 层排序性能远低于数据库层，别在内存里硬扛
跨系统组合排序时，优先级常被隐式覆盖
当 Laravel 查询结果再经 ES 搜索（如用 SearchableTrait），或 ES 返回后再用 Collection 排序，容易出现「数据库已排好，ES 又重排一遍，最后 PHP 又排一遍」——实际生效的只是最后一层。
典型陷阱：用 SearchableTrait 搜索后调 ->sortBy('score')，但该 trait 内部已按相关性打分并排序，额外调用反而打乱原本的 BM25 排序逻辑。
- 确认排序责任边界：数据库？ES？还是前端？三者不要重叠
- ES 的
multi_match中字段权重（如'title^10'）影响的是相关性分，不是最终展示顺序；sort才控制顺序 - 如果既要相关性又要业务字段优先级，得在 ES 中用
function_score+sort组合，不能靠客户端二次处理
orderByRaw("FIELD(id, ...)" 这类 MySQL 特有语法在换库时直接失效。优先级设置本身不难，难的是让每一层排序都各司其职、不互相干扰。
