Laravel中实现数据排序需用orderBy等方法：1.基础排序按字段及方向；2.多字段链式调用；3.动态排序须白名单校验；4.关联排序用join或load；5.深层嵌套需显式join；6.自定义逻辑用orderByRaw；7.性能优化须加索引并避免filesort。
如果您在 Laravel 应用中需要控制数据库查询结果的显示顺序，但发现数据未按预期排列，则可能是由于 orderBy 使用方式不当或排序字段缺乏索引支持。以下是实现正确、高效排序的具体操作步骤：
一、基础字段排序
最常用且安全的方式是直接对主模型表中的字段调用 orderBy 方法，它会生成标准 SQL ORDER BY 子句，并自动处理字段名转义（合法字段名无需额外处理）。
1、在控制器中使用链式调用：$users = User::orderBy('name', 'asc')->get();
2、省略方向参数时默认为升序：$posts = Post::orderBy('created_at')->get();
3、对时间字段使用 latest() 或 oldest() 快捷方法：$latestPost = Post::latest()->first();
二、多字段组合排序
当需按优先级逐层排序时，应将多个 orderBy 按执行顺序依次调用，后调用的同字段排序会覆盖前一次设置，不同字段则形成嵌套排序逻辑。
1、先按状态升序，再按创建时间降序：$items = Item::orderBy('status')->orderBy('created_at', 'desc')->get();
2、避免重复字段覆盖：不要写成 orderBy('id')->orderBy('id', 'asc')，否则仅生效最后一次调用；
3、如需动态组合，可使用数组循环构建：foreach ($sorts as $field => $direction) { $query->orderBy($field, $direction); }
三、特殊字段名安全排序
当字段名含空格、连字符或 MySQL 保留字（如 order、group）时，直接传入字符串会导致 SQL 语法错误，必须通过 DB::raw() 显式包裹并添加反引号。
1、使用 DB::raw 包裹非法字段名：$users = User::orderBy(DB::raw('`user-name`'))->get();
2、对来自请求的动态字段名，必须进行白名单校验：$allowedFields = ['name', 'email', 'created_at']; $field = in_array($request->input('order'), $allowedFields) ? $request->input('order') : 'id';
3、禁止将用户输入未经校验拼入 orderBy：直接使用 request('order') 构造 orderBy 存在 SQL 注入风险。
四、关联模型排序
with() 预加载不会使 orderBy 作用于关联模型，若需对关联数据排序，必须在关系定义中声明或使用延迟加载闭包，否则排序无效。
1、在模型关系方法中固定排序：public function posts() { return $this->hasMany(Post::class)->orderBy('published_at', 'desc'); }
2、使用 load() 延迟加载并指定排序：$user->load(['posts' => function ($q) { $q->orderBy('updated_at', 'desc'); }]);
3、错误示例：User::with('posts')->orderBy('posts.published_at', 'desc')->get() —— 该写法会报错，因 posts.published_at 不属于 users 表。
五、深层嵌套关联排序
Eloquent 不支持跨多层关系路径（如 file.property.address）直接排序，本质是 SQL 层无对应列，必须通过显式 join 将目标字段拉平至主查询作用域。
1、使用 join 关联多张表并引用别名字段：->join('finance_files as file', 'file.id', '=', 'finance_invoices.file_id')->join('properties as property', 'property.id', '=', 'file.property_id')
2、在 join 后调用 orderBy 引用已关联字段：->orderBy('property.full_address')
3、处理 NULL 值排序：->orderByRaw('COALESCE(property.full_address, "")')
六、自定义逻辑排序
当排序依赖表达式、JSON 字段提取或数据库特有函数（如 FIELD、JSON_EXTRACT）时，必须使用 orderByRaw，但需注意其绕过 Eloquent 校验、不可跨数据库兼容的特性。
1、按枚举值顺序排序：->orderByRaw("FIELD(status, 'draft', 'reviewing', 'published')")
2、按 JSON 字段内值排序（MySQL 8.0+）：->orderByRaw("JSON_EXTRACT(metadata, '$.priority') DESC")
3、中文拼音排序需依赖数据库 COLLATION 或函数：->orderByRaw("CONVERT(name USING gbk) COLLATE gbk_chinese_ci")
七、性能优化与索引配置
无索引字段执行 ORDER BY 会触发 filesort，导致查询随数据量增长急剧变慢，尤其在分页场景下易引发性能瓶颈。
1、为高频排序字段添加数据库索引：Schema::table('users', function (Blueprint $table) { $table->index('email'); });
2、避免在大表上对非索引字段排序：若 status 字段未建索引，$users = User::orderBy('status')->paginate(20) 可能严重卡顿；
3、验证排序是否命中索引：使用 ->toSql() 获取原始 SQL，配合 EXPLAIN 分析执行计划，确认 type 字段为 range 或 ref。
