Laravel-Backpack/CRUD 中使用 orderLogic 时的 ID 冲突问题解决方案

问题背景

在使用 Laravel-Backpack/CRUD 开发后台管理系统时，我们经常需要对数据表中的关联字段进行排序操作。CRUD 提供了 orderLogic 方法来实现自定义排序逻辑，但在实际使用中可能会遇到一个常见问题：当使用 leftJoin 进行关联表查询时，操作行的编辑/查看链接会显示错误的 ID。

问题现象

当我们在 CRUD 控制器中为关联字段配置 orderLogic 时，通常会这样写：

[
    'name' => 'freight_id',
    'label' => 'Freight',
    'type' => 'select',
    'entity' => 'freight',
    'orderable' => 'true',
    'orderLogic' => function ($query, $column, $columnDirection) {
        return $query
            ->leftJoin('freights', 'freights.id', '=', 'schedules.freight_id')
            ->orderBy('freights.description', $columnDirection);
    }
]

这种情况下，生成的 SQL 查询会包含 select *，导致关联表的 ID 覆盖了主表的 ID，进而使得操作链接使用了错误的 ID 值。

问题原因

问题的根源在于：

1. 默认情况下，Eloquent 会使用 select * 查询所有字段
2. 当使用 leftJoin 关联查询时，关联表的 ID 字段会覆盖主表的 ID 字段
3. Backpack/CRUD 依赖主表 ID 来生成操作链接，因此会使用错误的 ID

解决方案

解决这个问题的关键在于明确指定查询字段，避免字段冲突。具体方法是在 orderLogic 闭包中显式指定 select 语句：

'orderLogic' => function ($query, $column, $columnDirection) {
    return $query
        ->leftJoin('freights', 'freights.id', '=', 'schedules.freight_id')
        ->orderBy('freights.description', $columnDirection)
        ->select('schedules.*');  // 关键点：明确选择主表的所有字段
}

最佳实践

1. 始终指定主表字段：在使用 orderLogic 进行关联排序时，应该始终显式指定主表字段
2. 避免字段冲突：如果确实需要关联表的字段，可以使用 select 明确列出所需字段
3. 模型关系定义：确保模型关系正确定义，如示例中的 belongsTo 关系

class Schedule extends Model
{
    public function freight()
    {
        return $this->belongsTo(Freight::class, 'freight_id');
    }
}

总结

在 Laravel-Backpack/CRUD 中使用 orderLogic 进行关联排序时，必须注意 SQL 查询的字段选择问题。通过显式指定主表字段，可以避免 ID 冲突导致的操作链接错误。这一技巧不仅适用于简单的关联排序，也适用于更复杂的自定义查询场景。