Laravel Scout结合Typesense搜索报错：getCollection方法不存在

可能的原因及修复方案 #

1. 检查Scout驱动配置是否正确 #

确保config/scout.php中的驱动已设置为typesense，并配置好Typesense服务器参数：

'driver' => env('SCOUT_DRIVER', 'typesense'),

'typesense' => [
    'api_key' => env('TYPESENSE_API_KEY'),
    'nodes' => [
        [
            'host' => env('TYPESENSE_HOST'),
            'port' => env('TYPESENSE_PORT'),
            'protocol' => env('TYPESENSE_PROTOCOL', 'http'),
        ],
    ],
    'connection_timeout_seconds' => env('TYPESENSE_CONNECTION_TIMEOUT_SECONDS', 2),
],

2. 确认Laravel Scout与Typesense驱动版本兼容 #

版本不匹配是触发该错误的常见原因：

• Laravel Scout 10.x 对应 typesense/laravel-scout v1.x
• Laravel Scout 9.x 对应 typesense/laravel-scout v0.x

执行命令查看当前版本，若不兼容则升级/降级：

composer show laravel/scout typesense/laravel-scout

3. 修正模型中的方法命名（针对新版本驱动） #

如果使用typesense/laravel-scout v1.x及以上版本，集合Schema方法的命名已从getCollectionSchema改为typesenseCollectionSchema，修改模型代码如下：

// 替换原getCollectionSchema方法
public function typesenseCollectionSchema(): array {
    return [
        'name' => $this->searchableAs(),
        'fields' => [
            [
                'name' => 'id',
                'type' => 'string',
            ],
            [
                'name' => 'title',
                'type' => 'string',
            ],
            [
                'name' => 'created_at',
                'type' => 'int64',
            ],
        ],
        'default_sorting_field' => 'created_at',
    ];
}

4. 重新生成Typesense索引并导入数据 #

修改配置或模型方法后，需要重建索引并重新导入数据：

# 删除旧索引
php artisan scout:delete-index "todos"
# 创建新索引
php artisan scout:create-index "todos"
# 重新导入模型数据
php artisan scout:import "App\Models\Todo"

5. 清除配置缓存 #

确保新的驱动配置生效：

php artisan config:clear

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