Hoarder项目搜索功能故障排查与解决指南

问题现象

在Synology NAS上部署的Hoarder项目中，用户遇到了搜索功能失效的问题。具体表现为：

1. 任何搜索请求都返回"无书签"结果
2. 前端控制台无报错信息
3. 完整重建索引操作未能解决问题

日志分析

通过检查系统日志，发现以下关键信息：

Worker日志显示：

[search]任务失败：MDB_KEYEXIST错误（键值对已存在）

这表明索引过程中出现了重复键值的冲突。

Meilisearch日志显示：

POST /indexes/bookmarks/documents 202 Accepted
GET /tasks 200 OK

虽然HTTP状态码正常，但结合worker日志可以推断索引过程存在异常。

根本原因

经过技术分析，该问题可能由以下原因导致：

1. Meilisearch索引数据库损坏
2. 索引过程中出现数据冲突
3. 索引状态不一致导致搜索服务无法正常工作

解决方案

采用"清除-重建"策略：

1. 停止服务栈：确保所有相关服务完全停止
2. 清除Meilisearch目录：删除旧的索引数据
3. 重启容器：确保服务以干净状态启动
4. 完整重建索引：重新建立搜索索引

技术建议

1. 定期维护：建议定期检查Meilisearch服务状态
2. 监控机制：可设置监控任务检测索引异常
3. 备份策略：对搜索索引数据进行定期备份

经验总结

这类搜索服务故障通常与索引状态有关。当遇到类似问题时：

• 首先检查服务日志
• 确认索引任务是否正常完成
• 必要时采用清除重建策略

Hoarder作为优秀的书签管理工具，其搜索功能依赖Meilisearch服务。理解这一架构关系有助于快速定位和解决搜索相关问题。