错误代码

此页面是 Meilisearch API 错误详尽列表。

具有此 uid 的密钥已存在。

无法找到请求的 API 密钥。

请求无效，请检查错误消息了解更多信息。

请求的数据库已达到其最大尺寸。

某个文档超过了 每个文档的 65,535 个字段的最大限制。

无法获取请求的文档。它可能不存在，或者数据库处于不一致的状态。

转储创建过程中出现错误。任务已中止。

API 密钥的 actions 字段不可修改。

API 密钥的 createdAt 字段不可修改。

expiresAt API 密钥字段不可修改。

indexes API 密钥字段不可修改。

key API 密钥字段不可修改。

uid API 密钥字段不可修改。

updatedAt API 密钥字段不可修改。

uid 索引字段不可修改。

updatedAt 索引字段不可修改。

该 uid 的索引已存在，请参阅我们的 索引创建 指南。

尝试创建索引时发生错误，请参阅我们的 索引创建 指南。

未找到该 uid 的索引，请参阅我们的 索引创建 指南。

请求的索引已存在主键且 无法更改。

主键推断 失败，原因是收到的文档包含多个以 id 结尾的字段。使用 更新索引端点 手动设置主键。

美立搜遇到内部错误。检查错误消息及打开问题（如需要）。

请求的资源受 API 密钥保护。提供的 API 密钥无效。详细内容请参阅我们的安全教程。

提供的 API 密钥资源的actions 字段无效。它应表示操作名称的字符串数组。

提供的 API 密钥资源的description字段无效。它应为字符串或设置为null。

提供的 API 密钥资源的expiresAt 字段无效。它应显示RFC 3339格式的未来日期或日期时间，或设置为null。

提供的 API 密钥资源的indexes字段无效。它应表示索引名称的字符串数组。

limit 参数无效。应为整数。

给定的 name 无效。应为字符串或设置为null。

offset 参数无效。应为整数。

给定的 uid 无效。uid 必须遵循 uuid v4 格式。

传给 attributesToSearchOn 的值无效。attributesToSearchOn 接受一个字符串数组，表示文档属性。提供给 attributesToSearchOn 的属性必须出现在 searchableAttributes 列表 中。

Meilisearch 不支持 Content-Type 头。当前，Meilisearch 仅支持 JSON、CSV 和 NDJSON。

csvDelimiter 参数无效。它应该是字符串或 单个 ASCII 字符。

提供的 文档标识符 不符合格式要求。文档标识符必须为整数或字符串类型，仅由字母数字字符 (a-z A-Z 0-9)、连字符 (-) 和下划线 (_) 组成。

fields 参数无效。它应该是一个字符串。

如果出现以下情况，则会发生此错误

• filter 参数无效
  • 对于 使用 POST 端点获取文档，它应该是一个字符串、一个字符串数组或一个字符串数组数组
  • 对于 使用 GET 端点获取文档，它应该是一个字符串
• 用于筛选的属性未在filterableAttributes 列表中定义
• 筛选表达式缺少或具有无效操作符。阅读有关我们支持的操作符的更多信息

limit参数无效。它应当是一个整数。

offset参数无效。它应当是一个整数。

一个或多个文档提供的_geo字段无效。Meilisearch 希望_geo是一个具有两个字段的对象，lat和lng，每个字段都包含表示为字符串或浮点数的地理坐标。在我们的专用指南中阅读有关_geo以及如何进行故障排除的更多信息。

用于facetName字段的属性不是字符串或未在filterableAttributes列表中定义。

为facetQuery提供的值无效。它应该是字符串或null。

limit参数无效。它应当是一个整数。

offset参数无效。它应当是一个整数。

提供的索引格式中存在错误，请查看我们有关索引创建的指南。

primaryKey字段无效。它应该是字符串或设置为null。

多搜索查询包括federationOptions但顶级federation对象是null或缺失。

多搜索查询包含page，hitsPerPage，limit或offset，但顶级联合对象不是null。

一个多重搜索查询包含一个针对federated.weight的负值。

一个多重搜索请求中两个或更多个查询具有不兼容的结果。

attributesToCrop参数无效。它应该是字符串数组、字符串或设置为null。

attributesToHighlight参数无效。它应该是字符串数组、字符串或设置为null。

attributesToRetrieve参数无效。它应该是字符串数组、字符串或设置为null。

cropLength参数无效。它应该是整数。

cropMarker参数无效。它应该是字符串或设置为null。

如果出现以下情况，则会发生此错误

• facets参数无效。它应该是字符串数组、字符串或设置为null
• 用于分面的属性未在filterableAttributes列表中定义

如果出现以下情况，则会发生此错误

• filter参数的语法无效
• 用于筛选的属性未在filterableAttributes 列表中定义
• 使用诸如_geo、_geoDistance或_geoPoint之类的保留关键字作为筛选器

highlightPostTag参数无效。它应该是字符串。

highlightPreTag参数无效。它应该是字符串。

hitsPerPage参数无效。它应该是整数。

limit参数无效。它应该是整数。

locales 参数无效。

localizedAttributes 索引设定值无效。

matchingStrategy 参数无效。它应设定为 last 或 all。

offset 参数无效。它应为整数。

page 参数无效。它应为整数。

q 参数无效。它应为字符串或设定为 null。

搜索或多搜索请求中的 rankingScoreThreshold 不是介于 0.0 和 1.0 之间的数字。

showMatchesPosition 参数无效。它应为布尔值或设定为 null。

如果出现以下情况，则会发生此错误

• sort 参数的语法无效。
• 用于排序的属性没有在 sortableAttributes 列表中定义，或者设置中缺少 sort 排名规则。
• 保留关键字（如 _geo、_geoDistance、_geoRadius 或 _geoBoundingBox）用作过滤器。

displayed attributes 的值无效。它应为空数组、字符串数组或设定为 null。

distinct attributes 的值无效。它应为字符串或设定为 null。

为 sortFacetValuesBy 对象提供的数值不正确。接受的值为 alpha 或 count。

字段 maxValuesPerFacet 的值无效。它应该是整数或设置为 null。

可过滤属性 的值无效。它应该是空数组、字符串数组或设置为 null。

字段 maxTotalHits 的值无效。它应该是整数或设置为 null。

如果出现以下情况，则会发生此错误

• 设置有效负载 格式无效
• 指定了不存在的排名规则
• 自定义排名规则格式错误
• 保留关键字，例如 _geo、_geoDistance、_geoRadius、_geoBoundingBox 或 _geoPoint 被用作自定义排名规则

可搜索属性 的值无效。它应该是空数组、字符串数组或设置为 null。

指定的 `searchCutoffMs` 无效。它应该是表示毫秒数截止时间的整数。

可排序属性 的值无效。它应该是空数组、字符串数组或设置为 null。

停用词 的值无效。它应该是空数组、字符串数组或设置为 null。

同义词 的值无效。它应该是对象或设置为 null。

如果出现以下情况，则会发生此错误

• enabled 字段无效。它应该是布尔值或设置为 null
• disableOnAttributes 字段无效。它应该是字符串数组或设置为 null
• disableOnWords 字段无效。它应该是字符串数组或设置为 null
• minWordSizeForTypos 字段无效。它应该是一个整数或设置成 null
• 或者 oneTypo 或者 twoTypos 的值无效。它应该是一个整数或设置成 null

提供的目标文档标识符无效。文档标识符可以是整数类型或字符串类型，只能由字母数字字符(a-z A-Z 0-9)、连字符 (-) 和下划线 (_) 组成。

Meilisearch 找不到目标文档。确保您的目标文档标识符对应于索引中的文档。

attributesToRetrieve 无效。它应该是字符串数组、字符串或设置为 null。

filter 无效或包含了一个缺少或无效操作符的过滤表达式。过滤表达式对于 POST 端点必须是字符串、字符串数组或字符串数组数组。对于 GET 端点，它必须是字符串。

如果用于过滤的属性未在 filterableAttributes 列表中定义，Meilisearch 也会抛出此错误。

limit 无效。它应该是一个整数。

offset 无效。它应该是一个整数。

ranking_score 无效。它应该是一个布尔值。

ranking_score_details 无效。它应该是一个布尔值。

embedder 无效。它应该是一个对应于已配置 embedder 名称的字符串。

相似文档请求中的 rankingScoreThreshold 不是 0.0 和 1.0 之间的数字。

数据库处于无效状态。删除数据库并重新建立索引应该能解决这个问题。

data.ms 文件夹处于无效状态。你的 b 文件已损坏，或 data.ms 文件夹已用文件替换。

用于 indexes 数组中 交换索引 请求的索引在 indexes 数组中已声明了多次。每个索引仅需声明一次。

如果发生以下情况，则该错误会发生

• 对于交换操作，有效负载不精确包含两个索引 uid
• 有效负载中包含 indexes 中的无效索引名称

afterEnqueuedAt 查询参数无效。

afterFinishedAt 查询参数无效。

afterStartedAt 查询参数无效。

beforeEnqueuedAt 查询参数无效。

beforeFinishedAt 查询参数无效。

beforeStartedAt 查询参数无效。

canceledBy 查询参数无效。该参数应为整数。用逗号 (,) 分隔多个 uid。

indexUids 查询参数包含无效的索引 uid。

limit 参数无效。该参数必须为整数。

请求的任务状态无效。请使用一个 可能的值。

请求的任务类型无效。请使用其中一个 可能值。

将 uids 查询参数无效。

当主机系统在设备上没有剩余空间或数据库没有读写权限时，通常会发生此错误。

主键推理 失败，因为接收到的文档不包含以 id 结尾的任何字段。 手动指定主键，或将 some 结尾的字段添加到文档中 id 。

Content-Type 头 不匹配请求正文的负载格式，或者格式无效。

actions 字段从 payload 中缺失。

expiresAt 字段从 payload 中缺失。

indexes 字段从 payload 中缺失。

如果发生以下情况，则该错误会发生

• 请求的资源受到 API 密钥的保护，该密钥未在请求头中提供。有关更多信息，请查看我们的 安全教程
• 你正在为自己的版本使用错误的授权头。v0.24 及以下版本使用 X-MEILI-API-KEY: apiKey，而 v0.25 及以上版本使用 Authorization: Bearer apiKey

负载中不包含 Content-Type 头。目前，Meilisearch 仅支持 JSON、CSV 和 NDJSON。

此负载缺少 filter 字段。

某个文档不包含任何必需主键的值，因此无效。检查当前添加文档中无效的文档。

有效负载中缺少 uid 字段。

需要 facetName 参数。

您需要在访问 /keys 路由前设置一个主密钥。更多有关在启动时设置主密钥的信息，请阅读我们的 安全性教程。

指定了 Content-Type 头，但未向服务器发送请求正文，或请求正文为空。

索引交换有效负载缺少 indexes 对象。

取消任务 和 删除任务 端点需要其中一个可用的查询参数。

如果出现以下情况，则会发生此错误

• 主机系统分区达到最高容量，无法再接受写入
• 任务队列达到其限制并且无法再接受写入。您可以使用 删除任务端点 删除任务以继续写入操作

无法找到所请求的资源。

发送到服务器的有效负载太大。查看此 指南 以自定义 Meilisearch 接受的最大有效负载大小。

请求的任务不存在。请确保您正在使用正确的 uid。

索引大量文档（例如大小超过 3.5GB 的 JSON 文件）会导致 Meilisearch 打开的文件描述符过多。根据您的计算机，这可能会达到系统默认资源使用限制，并触发 too_many_open_files 错误。在运行 Meilisearch 之前，使用 ulimit 或类似工具来增加资源消耗限制。例如，在 UNIX 环境中调用 ulimit -Sn 3000 将允许打开的文件描述符数量提高到 3000。

您已达到并发搜索请求的上限。您可以通过重新启动您的实例并为 --experimental-search-queue-size 设置更高的值来配置它。

文档存在于存储，但出现了检索错误。这可能源自数据库中不一致的状态。

生成嵌入时出现错误。