Laravel Scout用database引擎忽略参数返回全表数据求助

• 确认Model是否正确引入Scout特性
  你的Task模型必须使用Laravel\Scout\Searchable trait，同时要明确定义参与搜索的字段：

  namespace App\Models;
  
  use Illuminate\Database\Eloquent\Model;
  use Laravel\Scout\Searchable;
  
  class Task extends Model
  {
      use Searchable;
  
      // 定义需要参与搜索的字段
      public function toSearchableArray()
      {
          return [
              'title' => $this->title,
              'description' => $this->description,
              // 补充你需要搜索的其他字段
          ];
      }
  }
  

  若表名不是模型默认的复数形式，还需显式定义searchableAs()方法指定对应表名。

• 检查数据库全文索引的字段匹配性
  迁移中添加的全文索引必须包含toSearchableArray()里定义的字段，示例迁移代码：

  Schema::table('tasks', function (Blueprint $table) {
      $table->fullText(['title', 'description']);
  });
  

  注意：MySQL环境下需确保表引擎为InnoDB（5.6及以上版本支持），且索引字段为char、varchar、text类型。

• 核对Scout的Database驱动配置
  在config/scout.php中，database驱动需明确指定连接、表名和索引名称：

  'database' => [
      'connection' => env('DB_CONNECTION', 'mysql'),
      'table' => 'tasks',
      'index' => 'tasks_title_description_index', // 与迁移中定义的全文索引名称一致
      'query_callback' => null,
  ],
  

• 排查搜索值是否为空
  当$value为空字符串或null时，Scout的database驱动默认返回全量数据，需确保传入的搜索关键词有效。

• 清除配置缓存
  若之前缓存过配置，执行sail artisan config:clear，确保SCOUT_DRIVER=database的环境变量生效。

• 验证数据库层面的全文搜索
  直接用SQL测试全文索引是否生效：

  SELECT * FROM tasks WHERE MATCH(title, description) AGAINST('你的搜索关键词');
  

  若SQL能返回正确结果，说明问题出在Scout的配置或Model定义上。

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