错误码
查阅此页面以获取您在使用 Meilisearch API 时可能遇到的所有错误的详尽列表。
此页面是 Meilisearch API 错误的详尽列表。
api_key_already_exists
具有此 uid 的密钥已存在。
api_key_not_found
找不到请求的 API 密钥。
bad_request
请求无效，请查看错误消息以获取更多信息。
batch_not_found
请求的批处理不存在。请确保您使用的是正确的 uid。
database_size_limit_reached
请求的数据库已达到其最大容量。
document_fields_limit_reached
文档超出 65,535 个字段的最大限制。
document_not_found
无法检索请求的文档。可能不存在，或者数据库处于不一致状态。
dump_process_failed
数据转储创建过程中发生错误。任务已中止。
facet_search_disabled
在 /facet-search 路由被查询时，facetSearch 索引设置被设置为 false。
feature_not_enabled
您尝试在未激活的情况下使用 实验性功能。
immutable_api_key_actions
API 密钥的 actions 字段无法修改。
immutable_api_key_created_at
API 密钥的 createdAt 字段无法修改。
immutable_api_key_expires_at
API 密钥的 expiresAt 字段无法修改。
immutable_api_key_indexes
API 密钥的 indexes 字段无法修改。
immutable_api_key_key
API 密钥的 key 字段无法修改。
immutable_api_key_uid
API 密钥的 uid 字段无法修改。
immutable_api_key_updated_at
API 密钥的 updatedAt 字段无法修改。
immutable_index_uid
索引的 uid 字段无法修改。
immutable_index_updated_at
索引的 updatedAt 字段无法修改。
index_already_exists
具有此 uid 的索引已存在，请查阅我们的 索引创建 指南。
index_creation_failed
创建索引时发生错误，请查阅我们的 索引创建 指南。
index_not_found
找不到具有此 uid 的索引，请查阅我们的 索引创建 指南。
index_primary_key_already_exists
请求的索引已有一个主键，该主键 无法更改。
index_primary_key_multiple_candidates_found
主键推断 失败，因为接收到的文档包含多个以 id 结尾的字段。使用 更新索引端点 手动设置主键。
internal
Meilisearch 发生内部错误。请检查错误消息，如有必要，请提交问题。
invalid_api_key
请求的资源受 API 密钥保护。提供的 API 密钥无效。请在我们的 安全教程 中了解更多信息。
invalid_api_key_actions
提供的 API 密钥资源的 actions 字段无效。它应该是一个表示动作名称的字符串数组。
invalid_api_key_description
提供的 API 密钥资源的 description 字段无效。它应该是一个字符串或设置为 null。
invalid_api_key_expires_at
提供的 API 密钥资源的 expiresAt 字段无效。它应该是一个未来的日期或时间，格式为 RFC 3339，或者设置为 null。
invalid_api_key_indexes
提供的 API 密钥资源的 indexes 字段无效。它应该是一个表示索引名称的字符串数组。
invalid_api_key_limit
limit 参数无效。它应该是一个整数。
invalid_api_key_name
给定的 name 无效。它应该是一个字符串或设置为 null。
invalid_api_key_offset
offset 参数无效。它应该是一个整数。
invalid_api_key_uid
给定的 uid 无效。uid 必须遵循 uuid v4 格式。
invalid_search_attributes_to_search_on
传递给 attributesToSearchOn 的值无效。attributesToSearchOn 接受一个字符串数组，指示文档属性。传递给 attributesToSearchOn 的属性必须存在于 searchableAttributes 列表中。
invalid_content_type
Content-Type 报头 Meilisearch 不支持此报头。目前，Meilisearch 仅支持 JSON、CSV 和 NDJSON。
invalid_document_csv_delimiter
csvDelimiter 参数无效。它应该是一个字符串或 单个 ASCII 字符。
invalid_document_id
提供的 文档标识符 不符合格式要求。文档标识符必须是整数或字符串类型，并且只能由字母数字字符（a-z A-Z 0-9）、连字符（-）和下划线（_）组成。
invalid_document_fields
fields 参数无效。它应该是一个字符串。
invalid_document_filter
如果发生以下情况，则会出现此错误：
filter参数无效- 对于 使用 POST 端点获取文档，它应该是一个字符串、字符串数组或字符串数组的数组
- 对于 使用 GET 端点获取文档，它应该是一个字符串
- 用于过滤的属性未在
filterableAttributes列表中定义 - 过滤表达式 缺少或包含无效运算符。了解更多关于我们支持的运算符
invalid_document_limit
limit 参数无效。它应该是一个整数。
invalid_document_offset
offset 参数无效。它应该是一个整数。
invalid_document_geo_field
一个或多个文档提供的 _geo 字段无效。Meilisearch 期望 _geo 是一个包含 lat 和 lng 两个字段的对象，每个字段都包含表示为字符串或浮点数的地理坐标。在我们的专用指南中了解更多关于 _geo 以及如何排除故障。
invalid_facet_search_facet_name
用于 facetName 字段的属性不是字符串，或者未在 filterableAttributes 列表中定义。
invalid_facet_search_facet_query
为 facetQuery 提供的值无效。它应该是一个字符串或 null。
invalid_index_limit
limit 参数无效。它应该是一个整数。
invalid_index_offset
offset 参数无效。它应该是一个整数。
invalid_index_uid
提供的索引格式有误，请查阅我们的 索引创建 指南。
invalid_index_primary_key
primaryKey 字段无效。它应该是一个字符串或设置为 null。
invalid_multi_search_query_federated
多重搜索查询包含 federationOptions，但顶级 federation 对象为 null 或缺失。
invalid_multi_search_query_pagination
多重搜索查询包含 page、hitsPerPage、limit 或 offset，但顶级 federation 对象不是 null。
invalid_multi_search_query_position
federationOptions.queryPosition 不是正整数。
invalid_multi_search_weight
多重搜索查询中 federated.weight 的值为负数。
invalid_multi_search_queries_ranking_rules
多重搜索请求中的两个或更多查询结果不兼容。
invalid_multi_search_facets
federation.facetsByIndex.<INDEX_NAME> 包含一个不在可过滤属性列表中的值。
invalid_multi_search_sort_facet_values_by
federation.mergeFacets.sortFacetValuesBy 不是字符串或不包含允许的值之一。
invalid_multi_search_query_facets
查询数组中的一个查询包含 facets，而 federation 存在且不为 null。
invalid_multi_search_merge_facets
federation.mergeFacets 不是一个对象或包含意外字段。
invalid_multi_search_max_values_per_facet
federation.mergeFacets.maxValuesPerFacet 不是正整数。
invalid_multi_search_facet_order
两个或更多索引对于相同的请求分面具有不同的 faceting.sortFacetValuesBy。
invalid_multi_search_facets_by_index
facetsByIndex 不是一个对象或包含未知字段。
invalid_multi_search_remote
federationOptions.remote 既不是 network.self，也不是 network.remotes 中的一个键。
invalid_network_self
网络对象 包含一个 self，它不是一个字符串或 null。
invalid_network_remotes
网络对象 包含一个 remotes，它不是一个对象或 null。
invalid_network_url
网络对象中的一个远程包含一个 url，它不是一个字符串。
invalid_network_search_api_key
网络对象中的一个远程包含一个 searchApiKey，它不是一个字符串或 null。
invalid_search_attributes_to_crop
attributesToCrop 参数无效。它应该是一个字符串数组、字符串或设置为 null。
invalid_search_attributes_to_highlight
attributesToHighlight 参数无效。它应该是一个字符串数组、字符串或设置为 null。
invalid_search_attributes_to_retrieve
attributesToRetrieve 参数无效。它应该是一个字符串数组、字符串或设置为 null。
invalid_search_crop_length
cropLength 参数无效。它应该是一个整数。
invalid_search_crop_marker
cropMarker 参数无效。它应该是一个字符串或设置为 null。
invalid_search_embedder
embedder 无效。它应该是一个字符串，对应于已配置的嵌入器名称。
invalid_search_facets
如果发生以下情况，则会出现此错误：
facets参数无效。它应该是一个字符串数组、字符串或设置为null- 用于分面的属性未在
filterableAttributes列表中定义
invalid_search_filter
如果发生以下情况，则会出现此错误：
filter参数的语法无效- 用于过滤的属性未在
filterableAttributes列表中定义 - 保留关键字，例如
_geo、_geoDistance或_geoPoint，被用作过滤器
invalid_search_highlight_post_tag
highlightPostTag 参数无效。它应该是一个字符串。
invalid_search_highlight_pre_tag
highlightPreTag 参数无效。它应该是一个字符串。
invalid_search_hits_per_page
hitsPerPage 参数无效。它应该是一个整数。
invalid_search_hybrid_query
hybrid 参数既不是 null，也不是对象，或者它是一个包含未知键的对象。
invalid_search_limit
limit 参数无效。它应该是一个整数。
invalid_search_locales
locales 参数无效。
invalid_settings_embedder
embedders 索引设置值无效。
invalid_settings_facet_search
facetSearch 索引设置值无效。
invalid_settings_localized_attributes
localizedAttributes 索引设置值无效。
invalid_search_matching_strategy
matchingStrategy 参数无效。它应该设置为 last 或 all。
invalid_search_offset
offset 参数无效。它应该是一个整数。
invalid_settings_prefix_search
prefixSearch 索引设置值无效。
invalid_search_page
page 参数无效。它应该是一个整数。
invalid_search_q
q 参数无效。它应该是一个字符串或设置为 null
invalid_search_ranking_score_threshold
搜索或多重搜索请求中的 rankingScoreThreshold 不是介于 0.0 和 1.0 之间的数字。
invalid_search_show_matches_position
showMatchesPosition 参数无效。它应该是一个布尔值或设置为 null。
invalid_search_sort
如果发生以下情况，则会出现此错误：
sort参数的语法无效- 用于排序的属性未在
sortableAttributes列表中定义，或者sort排序规则在设置中缺失 - 保留关键字，例如
_geo、_geoDistance、_geoRadius或_geoBoundingBox，被用作过滤器
invalid_settings_displayed_attributes
显示属性 的值无效。它应该是一个空数组、字符串数组或设置为 null。
invalid_settings_distinct_attribute
唯一属性 的值无效。它应该是一个字符串或设置为 null。
invalid_settings_faceting_sort_facet_values_by
为 sortFacetValuesBy 对象提供的值不正确。接受的值是 alpha 或 count。
invalid_settings_faceting_max_values_per_facet
maxValuesPerFacet 字段的值无效。它应该是一个整数或设置为 null。
invalid_settings_filterable_attributes
可过滤属性 的值无效。它应该是一个空数组、字符串数组或设置为 null。
invalid_settings_pagination
maxTotalHits 字段的值无效。它应该是一个整数或设置为 null。
invalid_settings_ranking_rules
如果发生以下情况，则会出现此错误：
- 设置负载 的格式无效
- 指定了一个不存在的排序规则
- 自定义排序规则格式错误
- 保留关键字，例如
_geo、_geoDistance、_geoRadius、_geoBoundingBox或_geoPoint，被用作自定义排序规则
invalid_settings_searchable_attributes
可搜索属性 的值无效。它应该是一个空数组、字符串数组或设置为 null。
invalid_settings_search_cutoff_ms
为 `searchCutoffMs 指定的值无效。它应该是一个表示截止时间（毫秒）的整数。
invalid_settings_sortable_attributes
可排序属性 的值无效。它应该是一个空数组、字符串数组或设置为 null。
invalid_settings_stop_words
停用词 的值无效。它应该是一个空数组、字符串数组或设置为 null。
invalid_settings_synonyms
同义词 的值无效。它应该是一个对象或设置为 null。
invalid_settings_typo_tolerance
如果发生以下情况，则会出现此错误：
enabled字段无效。它应该是一个布尔值或设置为nulldisableOnAttributes字段无效。它应该是一个字符串数组或设置为nulldisableOnWords字段无效。它应该是一个字符串数组或设置为nullminWordSizeForTypos字段无效。它应该是一个整数或设置为nulloneTypo或twoTypos的值无效。它应该是一个整数或设置为null
invalid_similar_id
提供的目标文档标识符无效。文档标识符可以是整数或字符串类型，只能由字母数字字符（a-z A-Z 0-9）、连字符（-）和下划线（_）组成。
not_found_similar_id
Meilisearch 找不到目标文档。请确保您的目标文档标识符与索引中的文档相对应。
invalid_similar_attributes_to_retrieve
attributesToRetrieve 无效。它应该是一个字符串数组、字符串或设置为 null。
invalid_similar_embedder
embedder 无效。它应该是一个字符串，对应于已配置的嵌入器名称。
invalid_similar_filter
filter 无效或包含缺少或无效运算符的过滤表达式。对于 POST 端点，过滤表达式必须是字符串、字符串数组或字符串数组的数组。对于 GET 端点，它必须是字符串。
如果用于过滤的属性未在 filterableAttributes 列表中定义，Meilisearch 也会抛出此错误。
invalid_similar_limit
limit 无效。它应该是一个整数。
invalid_similar_offset
offset 无效。它应该是一个整数。
invalid_similar_show_ranking_score
ranking_score 无效。它应该是一个布尔值。
invalid_similar_show_ranking_score_details
ranking_score_details 无效。它应该是一个布尔值。
invalid_similar_ranking_score_threshold
相似文档请求中的 rankingScoreThreshold 不是介于 0.0 和 1.0 之间的数字。
invalid_state
数据库处于无效状态。删除数据库并重新索引应该可以解决此问题。
invalid_store_file
data.ms 文件夹处于无效状态。您的 b 文件已损坏或 data.ms 文件夹已被文件替换。
invalid_swap_duplicate_index_found
在 indexes 数组中用于 交换索引 请求的索引已多次声明。您必须只声明每个索引一次。
invalid_swap_indexes
如果发生以下情况，则会出现此错误：
invalid_task_after_enqueued_at
afterEnqueuedAt 查询参数无效。
invalid_task_after_finished_at
afterFinishedAt 查询参数无效。
invalid_task_after_started_at
afterStartedAt 查询参数无效。
invalid_task_before_enqueued_at
beforeEnqueuedAt 查询参数无效。
invalid_task_before_finished_at
beforeFinishedAt 查询参数无效。
invalid_task_before_started_at
beforeStartedAt 查询参数无效。
invalid_task_canceled_by
canceledBy 查询参数无效。它应该是一个整数。多个 uid 应该用逗号（,）分隔。
invalid_task_index_uids
indexUids 查询参数包含无效的索引 uid。
invalid_task_limit
limit 参数无效。它必须是一个整数。
invalid_task_statuses
请求的任务状态无效。请使用 可能的值 之一。
invalid_task_types
请求的任务类型无效。请使用 可能的值 之一。
invalid_task_uids
uids 查询参数无效。
io_error
此错误通常发生在主机设备上没有剩余空间或数据库没有读写权限时。
index_primary_key_no_candidate_found
主键推断 失败，因为接收到的文档不包含任何以 id 结尾的字段。手动指定主键，或在文档中添加以 id 结尾的字段。
malformed_payload
Content-Type 报头 与请求体负载格式不匹配或格式无效。
missing_api_key_actions
actions 字段在负载中缺失。
missing_api_key_expires_at
expiresAt 字段在负载中缺失。
missing_api_key_indexes
indexes 字段在负载中缺失。
missing_authorization_header
如果发生以下情况，则会出现此错误：
- 请求的资源受 API 密钥保护，但请求头中未提供。请查阅我们的 安全教程 以获取更多信息
- 您正在使用与您的版本不符的授权头。v0.24 及以下版本使用
X-MEILI-API-KEY: apiKey，而 v0.25 及以上版本使用Authorization: Bearer apiKey
missing_content_type
负载不包含 Content-Type 报头。目前，Meilisearch 仅支持 JSON、CSV 和 NDJSON。
missing_document_filter
此负载缺少 filter 字段。
missing_document_id
文档不包含所需主键的任何值，因此无效。请检查当前添加的文档中是否存在无效文档。
missing_index_uid
负载缺少 uid 字段。
missing_facet_search_facet_name
facetName 参数是必需的。
missing_master_key
在访问 /keys 路由之前，您需要设置一个主密钥。在我们的 安全教程 中了解更多关于启动时设置主密钥的信息。
missing_network_url
网络对象中的一个远程不包含 url 字段。
missing_payload
指定了 Content-Type 报头，但未向服务器发送请求体，或者请求体为空。
missing_swap_indexes
索引交换负载缺少 indexes 对象。
missing_task_filters
no_space_left_on_device
如果发生以下情况，则会出现此错误：
- 主机系统分区达到最大容量，无法再接受写入
- 任务队列达到其限制，无法再接受写入。您可以使用 删除任务端点 以继续写入操作
not_found
找不到请求的资源。
payload_too_large
发送到服务器的负载过大。请查阅此 指南，以自定义 Meilisearch 接受的最大负载大小。
task_not_found
请求的任务不存在。请确保您使用的是正确的 uid。
too_many_open_files
索引大量文档批次，例如超过 3.5GB 的 JSON 文件，可能导致 Meilisearch 打开过多的文件描述符。根据您的机器，这可能会达到您系统的默认资源使用限制，并触发 too_many_open_files 错误。在运行 Meilisearch 之前，请使用 ulimit 或类似工具来增加资源消耗限制。例如，在 UNIX 环境中调用 ulimit -Sn 3000 以将允许的文件描述符数量提高到 3000。
too_many_search_requests
您已达到并发搜索请求的限制。您可以通过重新启动实例并为 --experimental-search-queue-size 设置更高的值来配置它。
unretrievable_document
文档存在于存储中，但在检索时发生错误。这可能源于数据库处于不一致状态。
vector_embedding_error
生成嵌入时出错。
远程联邦搜索错误
remote_bad_response
远程实例的响应此实例无法用作联邦搜索响应。
remote_bad_request
远程实例响应 400 BAD REQUEST。
remote_could_not_send_request
发送远程联邦搜索请求时发生错误。
remote_invalid_api_key
远程实例对本实例的请求响应 403 FORBIDDEN 或 401 UNAUTHORIZED。配置的搜索 API 密钥缺失、无效或缺少所需的搜索权限。
remote_remote_error
远程实例响应 500 INTERNAL ERROR。
remote_timeout
代理在分配的时间内没有响应。