Laravel Backpack：无模型使用CRUD控制器实现自定义查询列表

你的需求是完全支持的，不需要重写整个Backpack视图，只需要调整CRUD的数据源配置并解决视图的模型依赖问题，具体步骤如下：

1. 替换CRUD的数据源，手动注入查询结果 #

在你的CRUD控制器的setupListOperation()方法中，不要依赖默认的Eloquent模型查询，改为直接连接外部数据库执行自定义SQL，将结果转换为集合后赋值给CRUD的entries属性：

use Illuminate\Support\Facades\DB;

public function setupListOperation()
{
    // 1. 连接外部数据库（提前在config/database.php配置好连接）
    $externalConnection = DB::connection('your_external_db_connection');
    
    // 2. 执行用户自定义SQL
    $customSql = "SELECT column1, column2 FROM external_table WHERE ...";
    $rawResults = $externalConnection->select($customSql);
    
    // 3. 转换为集合，若结果无主键字段，手动添加唯一标识（Backpack默认依赖id作为行标识）
    $results = collect($rawResults)->map(function ($item, $index) {
        // 给每个条目添加id字段，避免视图报错
        $item->id = $index + 1;
        return $item;
    });
    
    // 4. 将结果赋值给CRUD的entries属性，替代默认的Eloquent查询
    $this->crud->entries = $results;
    
    // 5. 手动配置列表字段，对应SQL返回的列名
    $this->crud->addColumn([
        'name' => 'column1',
        'type' => 'text',
        'label' => '列1名称'
    ]);
    $this->crud->addColumn([
        'name' => 'column2',
        'type' => 'number',
        'label' => '列2名称'
    ]);
}

2. 解决视图的模型依赖问题 #

Backpack的列表视图默认会假设条目是Eloquent模型实例，调用getKeyName()等模型方法，直接用stdClass会报错。解决方法是创建一个空的Eloquent模型，不需要对应任何数据库表，仅用于兼容视图的模型依赖：

// app/Models/EmptyQueryResult.php
namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class EmptyQueryResult extends Model
{
    // 无需定义$table、$fillable等属性，仅作为视图兼容的占位模型
}

然后在CRUD控制器的setup()方法中设置这个空模型：

public function setup()
{
    $this->crud->setModel(\App\Models\EmptyQueryResult::class);
    $this->crud->setRoute(config('backpack.base.route_prefix') . '/custom-query');
    $this->crud->setEntityNameStrings('自定义查询结果', '自定义查询结果');
}

3. 避免使用依赖模型的字段类型 #

不要使用relationship、select_from_array（依赖模型枚举）等需要Eloquent模型支持的字段类型，仅使用text、number、date等基础字段类型即可。

总结 #

通过上述配置，你可以直接复用Backpack的标准列表视图展示自定义SQL的结果，不需要重写整个视图。只有当你需要高度定制化的UI时，才需要局部重写视图（比如复制Backpack的list.blade.php到resources/views/vendor/backpack/crud/目录下修改）。

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