3.3 KiB
Executable File
三连击： php artisan config:clear && php artisan scout:flush "App\Models\Articles" && php artisan scout:sync-index-settings && php artisan scout:import "App\Models\Articles"
============
🛡️ Laravel Scout + Meilisearch 维护手册 (药水哥版)
- 核心生存命令 (日常必点)
这些是你平时最常用的命令，每个都要烂熟于心：
全量导入 (Import) 当你第一次上线，或者数据库里突然多了几千条旧数据时执行：
Bash php artisan scout:import "App\Models\Articles" 清空索引 (Flush) 如果你发现数据全乱了，或者想推倒重来：
Bash php artisan scout:flush "App\Models\Articles" 同步配置 (Sync Settings) 你在 config/scout.php 里改了 searchableAttributes 或 sortableAttributes 后执行：
Bash php artisan scout:sync-index-settings 注意：如果报错没这个命令，就用我之前教你的 Tinker 方式强制更新。
- Tinker 调试“后门” (高级进阶)
当命令不生效时，直接进 Tinker 用代码说话：
PHP // 1. 检查模型转出的数组对不对 App\Models\Article::first()->toSearchableArray();
// 2. 查看 Meilisearch 当前的配置详情 (看看 searchableAttributes 到底有谁) $oClient = new Meilisearch\Client('http://127.0.0.1:7700'); dump($oClient->index('articles')->getSettings());
// 3. 强制删除某个索引（慎用，相当于删库） $oClient->deleteIndex('articles'); 3. 配置文件原则 (config/scout.php)
维护时，请确保你的 meilisearch 配置段长这样：
PHP 'meilisearch' => [ 'host' => env('MEILISEARCH_HOST', 'http://127.0.0.1:7700'), 'key' => env('MEILISEARCH_KEY', null), 'index-settings' => [ 'articles' => [ // 这里的名字要和 searchableAs() 一致 'searchableAttributes' => ['sTitle', 'sCategoryName', 'sContent'], // 搜索权限 'filterableAttributes' => ['iStatus', 'iCategoryId'], // 过滤权限 'sortableAttributes' => ['updated_at', 'iIsTop'], // 排序权限 ], ], ], 4. 药水哥的排避坑原则 (维护必读)
“不导不生效”原则： 你改了 Article.php 里的 toSearchableArray 逻辑（比如新增了字段），必须重新跑 scout:import，否则搜索引擎里永远是旧数据。
“先配后搜”原则： 如果你想在 search()->where(...) 里用某个字段，这个字段必须先出现在 filterableAttributes 里，不然会直接报错。
“队列观察”原则： 如果在 .env 里设置了 QUEUE_CONNECTION=redis（或其它），数据同步是异步的。如果发现搜不到，先去看看队列任务（php artisan queue:work）是不是卡住了。
“匈牙利命名”贯彻： 在索引里也保持 sTitle、iStatus 这种命名，这样你在前端看到 JSON 时，一眼就能分清类型，不容易写出 1 == '1' 这种低级错误。
- 紧急状况：搜索引擎连不上了？
如果程序报错 Connection refused，按这个顺序排查：
进程： ps aux | grep meilisearch 看看程序还在不在。
端口： lsof -i:7700 看看端口有没有被占用。
内存： Meilisearch 索引非常吃内存，如果服务器崩了，看看是不是 OOM（内存溢出）了。
兄弟，这份文档就是你的“定海神针”。以后不管是加字段还是改排序，按这个流程走，保证稳如老狗！