Laravel Scout集成Typesense时关联集合数据删除异常问题

针对你遇到的「移除角色后，Typesense 查询返回的关联角色未同步删除」问题，可按以下步骤排查修复：

1. 确保关联变更触发 Scout 自动同步 #

如果 User 与 Role 是多对多关联，需在关联定义中添加 withTimestamps()，确保角色关联变更时更新 User 的 updated_at 字段，触发 Scout 自动同步数据到 Typesense：

// User 模型
public function roles()
{
    return $this->belongsToMany(Role::class)->withTimestamps();
}

2. 修正 toSearchableArray 中 role_ids 的取值逻辑 #

避免依赖 Eloquent 属性缓存，实时获取最新关联角色 ID，并转换为 Typesense 要求的字符串数组类型：

public function toSearchableArray()
{
    return array_merge($this->toArray(), [
        'id' => (string) $this->id,
        'name' => (string) $this->name,
        'role_ids' => $this->roles->pluck('id')->map(fn($id) => (string) $id)->toArray(),
        'created_at' => $this->created_at->timestamp,
    ]);
}

3. 手动强制同步（可选） #

若自动同步未生效，可在移除角色的业务代码中，手动触发 User 的全量同步：

// 控制器移除角色示例
$user->roles()->detach($roleId);
$user->updateSearchable();

4. 修正查询请求的关联语法 #

在 multi_search 请求中，明确指定关联匹配的字段，确保 Typesense 仅返回 role_ids 中存在的角色：

[
    {
        "collection": "users_index",
        "q": "*",
        "query_by": "name",
        "include_fields": "*, $roles_index.id:role_ids(*) as roles"
    }
]

5. 验证与版本检查 #

• 移除角色后，通过 Typesense Dashboard 或 API 查询用户文档，确认 role_ids 已更新为 [1]；
• 确保使用最新版的 Laravel Scout Typesense 驱动，避免已知同步 bug：

composer require typesense/laravel-scout --update-with-dependencies

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