Laravel Scout + Meilisearch查询Product模型无结果问题求助

结合你提供的信息，raw() 能获取到Meilisearch的索引结果，说明索引数据是存在的，但 get() 返回空，核心原因是Laravel Scout无法将索引中的主键映射到数据库中的Product模型实例。以下是几种可能的排查方向：

1. 主键类型不匹配 #

检查Meilisearch索引中存储的_id类型，与数据库中Product表的主键类型是否一致：

• 比如索引中_id是字符串格式（如"1001"），但数据库主键是整数类型（1001），部分数据库在严格模式下会导致查询匹配失败。
• 可以通过raw()返回的结果查看_id的格式，再对比数据库中对应记录的主键格式。

2. 全局作用域/软删除限制 #

确认Product模型是否存在全局作用域（包括软删除），导致数据库查询被过滤：

• 如果模型使用了SoftDeletes trait，检查索引中的记录是否对应数据库中已被软删除的条目（deleted_at不为null）。Scout默认不会自动移除软删除的索引记录，此时raw()能查到，但get()会被软删除作用域过滤。
• 检查模型中是否有自定义全局作用域（如限制status为有效状态），而索引中的记录不满足该作用域条件。

3. 模型表名配置错误 #

验证Product模型的$table属性是否正确指向数据库中的对应表：

• 如果未显式设置$table，Laravel会默认使用模型名称的复数形式（如products），若实际表名不符，会导致数据库查询无结果。
• 可以通过执行\App\Models\Product\Product::find(索引中的_id)直接查询数据库，确认是否能找到记录。

4. Scout键名配置异常 #

虽然你提到getKey和getScoutKey返回正确，但仍需确认getScoutKeyName是否正确：

• 默认情况下Scout使用模型的primaryKey作为键名，但如果重写了getScoutKeyName方法，需确保返回的键名与Meilisearch索引中的主键字段一致（通常是_id）。
• 可以临时在模型中添加以下代码验证：

  public function getScoutKeyName()
  {
      return '_id'; // 确保与索引中的主键字段名一致
  }
  

5. 索引数据与数据库数据不同步 #

检查raw()返回的_id对应的记录是否在数据库中存在：

• 可能存在索引未及时更新的情况（比如数据库中记录已删除，但索引未清理），此时raw()能查到索引数据，但数据库中已无对应记录，导致get()返回空。
• 可以手动执行\App\Models\Product\Product::search('iphone')->raw()['hits'][0]['_id']拿到主键，再用Product::find(该主键)确认数据库中是否存在。

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