orderBy仅作用于主表字段，动态排序须白名单校验，关联字段排序需join或withCount，ID置顶用orderByRaw；firstWhere不参与排序。
直接用 orderBy 就能排序，但多数问题出在“该在哪一层排”“字段能不能直接写”“用户输入敢不敢信”这三块。别碰 firstWhere 想搞排序，它不干这事。
基础排序：字段必须属于主表，方向可省略
orderBy 只作用于当前查询的主表字段。比如 User::orderBy('name') 生成的是 ORDER BY users.name ASC，Laravel 自动加表前缀和转义，安全。
- 省略第二个参数时默认
asc，orderBy('created_at')等价于orderBy('created_at', 'asc') - 时间字段优先用快捷方法：
latest()（ORDER BY created_at DESC）和oldest()（ASC） - 字段含空格、连字符或 MySQL 保留字（如
order、group）时，必须用DB::raw('`user-name`')包裹，否则报错
动态排序：白名单校验是硬性要求，不是建议
用户传来的 request('sort') 和 request('direction') 不能直接进 orderBy。没校验=SQL 注入入口。
- 只允许预设字段：
$allowed = ['name', 'email', 'updated_at']; $field = in_array($request->sort, $allowed) ? $request->sort : 'id'; - 方向也得限制：
$dir = in_array($request->dir, ['asc', 'desc']) ? $request->dir : 'asc'; - 禁止拼字符串：
orderBy($field . ' ' . $dir)是错的；必须拆成两个参数：orderBy($field, $dir)
关联字段排序：with() 里的 orderBy 不影响主列表顺序
写 User::with('posts')->orderBy('posts.title') 会报 Unknown column 'posts.title' —— 因为主查询只查 users 表，posts.title 根本不在 SELECT 范围里。
- 真要按关联字段排主模型，用
join()：User::join('posts', 'users.id', '=', 'posts.user_id')->orderBy('posts.title') - 只关心数量（如评论数），用
withCount()：Post::withCount('comments')->orderByDesc('comments_count') - 小数据量且已全量加载，可用集合排序：
collect($users)->sortBy('posts.0.title')，但必须接->values()重置键名，且不能用于分页场景
ID 置顶等自定义排序：用 orderByRaw，别绕弯
想让 ID=123 的记录永远排第一，其余按 ID 升序？firstWhere 不行，where()->get() 也不行——它不控制顺序。
- 核心技巧：
orderByRaw('id = ? DESC', [$targetId])，布尔表达式转整数，true → 1，false → 0，DESC让 1 排最前 - 后续补二级排序保证其余记录有序：
orderByRaw('id = ? DESC', [$targetId])->orderBy('id', 'asc') - 多条件置顶（如按状态+ID）：
orderByRaw("CASE WHEN status = 'active' THEN 1 WHEN status = 'pending' THEN 2 ELSE 3 END")
最容易被忽略的是：所有涉及关联、子查询、多态或用户输入的排序，数据库层面看不到的字段，就别指望 orderBy 能生效；而所有没做白名单或参数绑定的动态排序，都在生产环境裸奔。
