错误代码

本页是 Meilisearch API 错误的详尽列表。

具有此uid的密钥已存在。

找不到请求的 API 密钥。

请求无效，请查看错误消息以获取更多信息。

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

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

无法检索请求的文档。 它要么不存在，要么数据库处于不一致的状态。

转储创建过程中发生错误。 任务已中止。

已查询/facet-search路由，而facetSearch索引设置设置为false。

API 密钥的actions字段无法修改。

API 密钥的createdAt字段无法修改。

API 密钥的expiresAt字段无法修改。

API 密钥的 indexes 字段无法修改。

API 密钥的 key 字段无法修改。

API 密钥的 uid 字段无法修改。

API 密钥的 updatedAt 字段无法修改。

索引的 uid 字段无法修改。

索引的 updatedAt 字段无法修改。

具有此 uid 的索引已存在，请查看我们的 索引创建 指南。

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

未找到具有此 uid 的索引，请查看我们的 索引创建 指南。

请求的索引已有一个主键，无法更改。

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

Meilisearch 发生内部错误。请检查错误消息，如有必要，提交一个 issue。

请求的资源受 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，但顶级的 federation 对象不为 null。

多重搜索查询的 federated.weight 包含负值。

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

federation.facetsByIndex.<INDEX_NAME> 包含的值不在可筛选属性列表中。

federation.mergeFacets.sortFacetValuesBy 不是字符串，或者不包含允许的值。

当存在 federation 且不为 null 时，queries 数组中的查询包含 facets。

federation.mergeFacets 不是一个对象，或包含意外字段。

federation.mergeFacets.maxValuesPerFacet 不是一个正整数。

对于相同的请求分面，两个或多个索引具有不同的 faceting.sortFacetValuesBy。

facetsByIndex 不是一个对象，或包含未知字段。

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

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

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

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

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

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

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

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

• filter 参数的语法无效
• 用于过滤的属性未在 filterableAttributes 列表中定义
• 保留关键字（如 _geo、_geoDistance 或 _geoPoint）被用作过滤器

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

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

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

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

locales 参数无效。

facetSearch 索引设置值无效。

localizedAttributes 索引设置值无效。

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

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

prefixSearch 索引设置值无效。

page 参数无效。它应该是一个整数。

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

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

showMatchesPosition 参数无效。它应该是一个布尔值或设置为 null。

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

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

显示的属性的值无效。它应该是一个空数组、一个字符串数组或设置为 null。

不同的属性的值无效。它应该是一个字符串或设置为 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 无效。它应该是一个与已配置的嵌入器名称对应的字符串。

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

数据库处于无效状态。删除数据库并重新索引应该可以解决问题。

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

在 indexes 数组中用于交换索引请求的索引已被多次声明。您必须每个索引只声明一次。

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

• 对于交换操作，有效负载不包含正好两个索引 uids
• 有效负载在 indexes 数组中包含无效的索引名称

afterEnqueuedAt 查询参数无效。

afterFinishedAt 查询参数无效。

afterStartedAt 查询参数无效。

beforeEnqueuedAt 查询参数无效。

beforeFinishedAt 查询参数无效。

beforeStartedAt 查询参数无效。

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

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

limit 参数无效。它必须是一个整数。

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

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

uids 查询参数无效。

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

主键推断失败，因为接收的文档不包含任何以 id 结尾的字段。手动指定主键，或者在您的文档中添加一些以 id 结尾的字段。

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

有效负载中缺少 actions 字段。

有效负载中缺少 expiresAt 字段。

有效负载中缺少 indexes 字段。

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

• 请求的资源受到请求头中未提供的 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 设置为更高的值来配置它。

文档存在于存储中，但在检索时发生错误。这可能是由于数据库中存在不一致的状态。

生成嵌入时出错。