错误代码

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

具有此uid的密钥已存在。

找不到请求的 API 密钥。

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

请求的批处理不存在。请确保您使用的是正确的uid。

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

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

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

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

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

您尝试使用实验性功能，但未激活它。

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 提供的value无效。它应该是字符串或 null。

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

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

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

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

多重搜索查询包含 federationOptions，但顶层 federation 对象为 null 或缺失。

多重搜索查询包含 page、hitsPerPage、limit 或 offset，但顶层 federation 对象不为 null。

federationOptions.queryPosition 不是正整数。

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

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

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

federation.mergeFacets.sortFacetValuesBy 不是字符串或不具有允许的值之一。

当存在联合且非 null 时，查询数组中的查询包含 facets。

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

federation.mergeFacets.maxValuesPerFacet 不是正整数。

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

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

federationOptions.remote 不是 network.self，也不是 network.remotes 中的键。

network 对象包含的 self 不是字符串或 null。

network 对象包含的 remotes 不是对象或 null。

network 对象中的一个 remote 包含的 url 不是字符串。

network 对象中的一个 remote 包含的 searchApiKey 不是字符串或 null。

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

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

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

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

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

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

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

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

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

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

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

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

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

hybrid 参数既不是 null 也不是对象，或者它是一个包含未知键的对象。

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

locales 参数无效。

embedders 索引设置值无效。

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。

distinct 属性的值无效。它应该是字符串或设置为 null。

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

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

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

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

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

• 设置 payload 的格式无效。
• 指定的排名规则不存在。
• 自定义排名规则格式错误。
• 保留关键字（如 _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。

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

filter 无效或包含带有缺失或无效运算符的过滤器表达式。对于 POST 端点，过滤器表达式必须是字符串、字符串数组或字符串数组的数组。对于 GET 端点，它必须是字符串。

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

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

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

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

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

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

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

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

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

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

• payload 不包含正好两个索引 uids 以进行交换操作。
• payload 在 indexes 数组中包含无效的索引名称。

afterEnqueuedAt 查询参数无效。

afterFinishedAt 查询参数无效。

afterStartedAt 查询参数无效。

beforeEnqueuedAt 查询参数无效。

beforeFinishedAt 查询参数无效。

beforeStartedAt 查询参数无效。

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

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

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

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

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

uids 查询参数无效。

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

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

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

payload 中缺少 actions 字段。

payload 中缺少 expiresAt 字段。

payload 中缺少 indexes 字段。

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

• 请求的资源受 API 密钥保护，但请求标头中未提供该密钥。请查看我们的安全教程以获取更多信息。
• 您正在为您的版本使用错误的授权标头。 v0.24 及更低版本使用 X-MEILI-API-KEY: apiKey，而 v0.25 及更高版本使用 Authorization: Bearer apiKey。

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

此 payload 缺少 filter 字段。

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

payload 缺少 uid 字段。

facetName 参数是必需的。

您需要设置主密钥才能访问 /keys 路由。请阅读我们的安全教程，详细了解如何在启动时设置主密钥。

network 对象中的一个 remote 不包含 url 字段。

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

索引交换 payload 缺少 indexes 对象。

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

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

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

找不到请求的资源。

发送到服务器的 payload 太大。请查看此指南，以自定义 Meilisearch 接受的最大 payload 大小。

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

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

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

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

生成嵌入时出错。

远程实例返回的响应无法用作联合搜索响应。

远程实例返回 400 BAD REQUEST。

发送远程联合搜索请求时发生错误。

远程实例对本实例的请求返回 403 FORBIDDEN 或 401 UNAUTHORIZED。配置的搜索 API 密钥缺失、无效或缺少所需的搜索权限。

远程实例返回 500 INTERNAL ERROR。

代理未在分配的时间内响应。