核心用法
Meilisearch 是一款开源、轻量级的搜索引擎，主打极速全文检索与实时搜索体验。本技能聚焦于部署、索引调优与生产级配置，涵盖从基础索引设置到高级过滤、排序、权限管理的完整链路。
索引配置关键
- filterableAttributes / sortableAttributes 必须前置声明：添加文档前必须预先定义，后期修改将触发全量重建索引
- 批量修改设置：任何索引设置变更都会触发重建，建议集中批量配置
- searchableAttributes 顺序影响排名：优先级从高到低排列，而非按字母序
- displayedAttributes 默认暴露全部字段：建议显式限制以减少响应体积
索引操作要点
- 异步任务机制：更新操作返回 taskUid，需轮询
/tasks/{uid}确认完成状态 - 显式指定主键：嵌套或数组字段会导致主键推断失败
- 批量大小优化：10-50MB 批次效率最佳，避免单文档逐条导入
- 无真正部分更新：单字段修改仍需发送完整文档
搜索与过滤行为
- 首字符容错限制：首字母不支持拼写容错，"tset" 无法匹配 "test"
- 过滤语法差异：范围查询使用
TO而非 SQL 的BETWEEN - 默认多词 OR 匹配：短语匹配需显式加引号
- 高亮依赖索引配置：仅对 searchableAttributes 生效
生产安全与性能
- Master Key 强制启用：生产环境必须设置，否则全端点公开
- 细粒度 API 密钥：支持按索引、操作类型、过期时间隔离权限
- 单节点架构：无集群能力，垂直扩展依赖内存
- 内存映射限制：索引大小受 RAM 约束，100MB 单次请求上限
显著优点
- 极低启动门槛：单二进制部署，分钟级可用
- 实时搜索体验：Typo-tolerance、分词、高亮开箱即用
- 开发者友好：RESTful API、多语言 SDK、清晰错误返回
- 轻量级替代：相比 Elasticsearch 资源占用更低，适合中小规模场景
潜在缺点与局限
| 局限领域 | 具体表现 |
|---------|---------|
| 架构扩展 | 无原生集群，单节点瓶颈，内存即容量上限 |
| 更新机制 | 无真正部分更新，单字段修改成本等同于全文档重写 |
| 任务队列 | 无优先级调度，大重建任务会阻塞小文档添加 |
| 备份恢复 | 仅支持快照，无连续复制或增量备份 |
| 分页深度 | 最大 1000 条/请求，无游标深度分页 |
| 过滤容错 | 未声明的过滤字段静默返回空结果，无错误提示 |
适合人群
- 需要快速搭建搜索功能的中小团队
- 从 PostgreSQL LIKE 查询迁移至专业搜索的开发者
- 资源受限场景（低内存、单服务器）下的 Elastic 替代方案评估者
- 注重开发体验、希望减少运维复杂度的技术决策者
常规风险
1. 数据丢失风险：快照非连续备份，需自行制定 RPO/RTO 策略
2. 配置漂移陷阱：索引设置误操作触发意外全量重建，影响线上查询
3. 权限泄露：Master Key 外泄或误配置公开实例导致数据暴露
4. 内存压力：索引增长超出物理内存时性能骤降或 OOM
5. 任务堆积：批量导入未控制速率导致队列拥塞，实时写入延迟
版本与生态说明
- 当前技能基于 Meilisearch v1.x 行为编写
- 云托管版本（Meilisearch Cloud）部分限制可能由平台层抽象
- 建议生产部署前验证具体版本变更日志