Meilisearch任务队列冻结故障求助：索引任务停滞无响应

• 确认Meilisearch版本：部分旧版本（如v0.28.x及更早）存在超大索引场景下任务队列阻塞的已知问题，建议升级至最新稳定版本后重试。
• 排查磁盘IO瓶颈：尽管剩余存储空间充足，但机械硬盘在处理大索引后续操作时，可能因IO等待导致单线程CPU满负载（看似100%占用实际是IO等待的用户态消耗）。可通过iostat或iotop工具查看磁盘读写速率与等待时间，若为IO瓶颈，切换至SSD可显著改善。
• 检查任务队列存储：Meilisearch的任务状态存储在data.ms/tasks.db文件中，若该文件损坏或异常，会导致任务处理停滞。操作步骤：停止服务→完整备份data.ms目录→删除tasks.db文件→重启服务→重新提交所需任务（注意：删除后未完成的任务会丢失，需重新触发）。
• 分析CPU占用线程：用htop查看Meilisearch进程的线程详情，定位到100%占用的线程ID，再通过perf top -p <进程ID>分析该线程的函数调用栈，确认是否为死循环或特定索引操作导致的阻塞。
• 导出重建索引：若上述方法无效，可先通过POST /indexes/<indexUID>/dump导出当前索引快照，随后重置Meilisearch（删除data.ms目录），重启服务后使用meilisearch --import-dump <dump文件路径>重新导入数据，此方式可绕过损坏的任务队列状态。

社区中已有不少用户遇到类似大索引任务阻塞问题，多数与旧版本bug、磁盘IO性能不足或任务队列文件异常相关。

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