Laravel中如何基于belongsTo关联模型实现动态orderBy排序

问题原因 #

默认Eloquent关联为懒加载，执行主表User查询时并未关联companies表，直接使用company.name作为排序字段会触发字段不存在错误。

实现方案（无join，代码简洁） #

1. 先更新可排序字段配置 #

$columns = collect([
    'username' => 'Username',
    'email' => 'Email',
    'company.id' => '公司ID',
    'company.name' => '公司名称',
    'company.code' => '公司编码'
]);

2. 修改查询逻辑，增加关联字段排序处理 #

$query = User::where('company_id', Auth::user()->company_id)
    ->search(trim($this->search));

// 动态判断排序字段类型
if (str_contains($this->column, '.')) {
    // 拆分关联标识和关联字段
    [$relation, $relationColumn] = explode('.', $this->column, 2);
    // 子查询实现关联排序，无需join
    $query->orderBy(
        \App\Models\Company::select($relationColumn)
            ->whereColumn('companies.id', 'users.company_id'),
        $this->order
    );
} else {
    // 主表字段直接排序
    $query->orderBy($this->column, $this->order);
}

$users = $query->paginate($this->size);

注意事项 #

• 代码中的\App\Models\Company需要替换为你项目中实际的Company模型命名空间
• 该方案为Laravel原生支持的关联排序方式，执行效率等同于join，同时不会破坏原有查询结构，可复用性强
• 如果是多个层级的belongsTo关联，也可以通过相同逻辑扩展拆分字段实现排序

可选join实现（仅适用于复杂查询场景）：

// 关联字段排序用join实现
$query->join('companies', 'users.company_id', '=', 'companies.id')
    ->orderBy("companies.{$relationColumn}", $this->order)
    ->select('users.*'); // 必须指定主表字段，避免同名字段覆盖

内容的提问来源于stack exchange，提问作者kgcusi