meilisearch v1.27.0 版本更新介绍

发布日期: 2025-11-24
版本号: v1.27.0

此次 v1.27.0 版本更新主要改进了批量处理性能以提升任务摄入速度，修复了可能导致嵌入操作中部分文档被跳过的错误（具体影响使用 Hugging Face 嵌入器时批次中每第 available_parallelism 个文档，或使用 REST 嵌入器时每批次第 40 个文档），并解决了 /documents/fetch 端点在分页排序文档时可能出现重复搜索结果的问题。此外，更新还优化了向 S3 上传快照时的错误信息以便于调试，并更新了 CI 以兼容 macOS Sonoma 平台。

更新内容 （中文）

本版本改进了批处理大小以提升性能，同时修复了嵌入器可能在生成过程中跳过部分文档的错误，并解决了文档路由在多页显示相同文档的问题。此外，优化了上传快照至S3时的错误信息质量，有助于调试。

⚙️ 兼容性支持

• 由 @Kerollmops 在 https://github.com/meilisearch/meilisearch/pull/6001 中更新CI的macOS平台版本 Meilisearch的macOS二进制文件现基于macOS Sonoma（macos-14）生成

✨ 增强功能

• 由 @Kerollmops 在 https://github.com/meilisearch/meilisearch/pull/5994 中为改进S3快照上传调试，在任务队列中显示错误
• 批量任务总大小现默认为最大索引内存的一半，以优化任务摄入，由 @Kerollmops 在 https://github.com/meilisearch/meilisearch/pull/5990 和 https://github.com/meilisearch/meilisearch/pull/6005 中实现

🪲 错误修复

• 由 @dureuill 在 https://github.com/meilisearch/meilisearch/pull/5995 中修复了可能导致Meilisearch在执行嵌入操作时跳过部分文档的问题
  • 使用Hugging Face嵌入器时，批次中每 available_parallelism 个文档会被忽略用于嵌入 https://github.com/meilisearch/meilisearch/issues/5976
  • 使用每次请求仅一个嵌入的REST嵌入器时，批次中每40个文档会被忽略用于嵌入
  • 验证数据库中的文档是否受影响：
    1. 启用 multimodal 实验性功能
    2. 通过搜索或过滤器 NOT _vectors EXISTS 查找无向量的文档。
• 由 @ManyTheFish 在 https://github.com/meilisearch/meilisearch/pull/5999 中修复了 /documents/fetch 在分页排序文档时可能导致搜索结果重复的错误

完整变更日志：https://github.com/meilisearch/meilisearch/compare/v1.26.0…v1.27.0

更新内容 （原始）

This release improves the batch size for better performance. It also fixes bugs with the embedders that could skip some documents during generation and resolves an issue with the document route that displayed the same documents on multiple pages. It improves the quality of error messages when uploading snapshots to S3, which helps with debugging.

⚙️ Compatibility support

• Update macOS platform version in the CI by @Kerollmops in https://github.com/meilisearch/meilisearch/pull/6001 Meilisearch MacOS binaries now generated with MacOS Sonoma (macos-14)

✨ Enhancement

• Show errors in the task queue to improve debugging of S3 snapshot uploads by @Kerollmops in https://github.com/meilisearch/meilisearch/pull/5994
• Batched tasks total size now defaults to half of the max indexing memory to improve task ingestion by @Kerollmops in https://github.com/meilisearch/meilisearch/pull/5990 & https://github.com/meilisearch/meilisearch/pull/6005

🪲 Bug fixes

• Fix issue that could cause Meilisearch to skip some documents when performing embedding operations by @dureuill in https://github.com/meilisearch/meilisearch/pull/5995
  • Every available_parallelismth document in a batch was ignored for the purpose of embedding when using a Hugging Face embedder https://github.com/meilisearch/meilisearch/issues/5976
  • Every 40th document in a batch was ignored for the purpose of embedding when using a REST embedder with only one embedding per request
  • To verify if documents in your database have been affected:
    1. enable the multimodal exp. feature
    2. search or fetch with filter: NOT _vectors EXISTS to find documents without vectors.
• Fix /documents/fetch bug that could cause duplicated search results when paginating sorted documents by @ManyTheFish in https://github.com/meilisearch/meilisearch/pull/5999

Full Changelog: https://github.com/meilisearch/meilisearch/compare/v1.26.0...v1.27.0

下载链接

• meilisearch-linux-aarch64
• meilisearch-linux-amd64
• meilisearch-macos-apple-silicon
• meilisearch-openapi.json
• meilisearch-windows-amd64.exe
• meilisearch.deb