本页面列出了 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

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

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 字段不可修改。

immutable_webhook

您尝试修改预留的 webhook。预留 webhook 由 Meilisearch Cloud 配置,其 isEditable 设置为 true。使用实例选项创建的 webhook 也是不可变的。

immutable_webhook_uuid

您尝试手动设置 webhook 的 uuid。Meilisearch 会自动为 webhook 生成 uuid

immutable_webhook_is_editable

您尝试手动设置 webhook 的 isEditable 字段。Meilisearch 会自动为所有 webhook 设置 isEditable。只有预留 webhook 的 isEditable 设置为 false

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_search_media

传递给 media 的值不是有效的 JSON 对象。

invalid_search_media_and_vector

搜索查询中 mediavector 的值都不是 null。这两个参数是互斥的,因为 media 通过 hybrid 中配置的嵌入器生成向量嵌入。

invalid_content_type

Meilisearch 不支持 Content-Type 标头。目前,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

此错误发生在以下情况:

invalid_document_limit

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

invalid_document_offset

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

invalid_document_sort

此错误发生在以下情况:
  • sort 参数的语法无效
  • 用于排序的属性未在 sortableAttributes 列表或 sort 排序规则中定义。
  • 诸如 _geo_geoDistance_geoRadius_geoBoundingBox 之类的保留关键字被用作过滤器

invalid_document_geo_field

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

invalid_export_url

导出目标实例 URL 无效或无法访问。

invalid_export_api_key

提供的安全密钥没有访问目标实例所需的权限。

invalid_export_payload_size

提供的负载大小无效。负载大小必须是表示最大负载大小的人类可读格式的字符串。

invalid_export_indexes_patterns

提供的索引模式无效。索引模式必须是字母数字字符串,可选地包含通配符。

invalid_export_index_filter

提供的索引导出过滤器不是有效的 过滤器表达式

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

多重搜索查询包含 pagehitsPerPagelimitoffset,但顶层 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

此错误发生在以下情况:

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 索引设置值无效。 facetSearch 索引设置值无效。

invalid_settings_localized_attributes

localizedAttributes 索引设置值无效。

invalid_search_matching_strategy

matchingStrategy 参数无效。它应该设置为 lastall

invalid_search_offset

offset 参数无效。它应该是一个整数。 prefixSearch 索引设置值无效。

invalid_search_page

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

invalid_search_q

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

invalid_search_ranking_score_threshold

搜索或多重搜索请求中的 rankingScoreThreshold 不是介于 0.01.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 对象提供的值不正确。接受的值为 alphacount

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 字段无效。它应该是一个布尔值或设置为 null
  • disableOnAttributes 字段无效。它应该是一个字符串数组或设置为 null
  • disableOnWords 字段无效。它应该是一个字符串数组或设置为 null
  • minWordSizeForTypos 字段无效。它应该是一个整数或设置为 null
  • oneTypotwoTypos 的值无效。它应该是一个整数或设置为 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.01.0 之间的数字。

invalid_state

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

invalid_store_file

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

invalid_swap_duplicate_index_found

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

invalid_swap_indexes

此错误发生在以下情况:
  • 负载不包含用于交换操作的恰好两个索引 uid
  • 负载在 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 查询参数无效。

invalid_webhooks

创建 webhook 请求不包含有效的 JSON 负载。当您尝试创建超过 20 个 webhook 时,Meilisearch 也会返回此错误。

invalid_webhook_url

提供的 webhook URL 不是有效的 JSON 字符串,为 null,缺失,或其值无法解析为有效的 URL。

invalid_webhook_headers

提供的 webhook headers 字段不是 JSON 对象或不是有效的 HTTP 标头。如果您为单个 webhook 设置超过 200 个标头字段,Meilisearch 也会返回此错误。

invalid_webhook_uuid

提供的 webhook uuid 不是有效的 uuid v4 值。

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

生成嵌入时出错。当嵌入提供程序服务当前不可用时,您通常会看到此错误。大多数提供程序都提供状态页面来监控其服务的状态,例如 OpenAI 的 https://status.openai.com/ 无法访问嵌入提供程序错误通常会包含一条消息,说明 Meilisearch“无法访问嵌入服务器”。

远程联邦搜索错误

remote_bad_response

远程实例回复的响应无法用作此实例的联邦搜索响应。

remote_bad_request

远程实例回复 400 BAD REQUEST

remote_could_not_send_request

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

remote_invalid_api_key

远程实例对此实例的请求回复 403 FORBIDDEN401 UNAUTHORIZED。配置的搜索 API 密钥可能缺失、无效或缺少所需的搜索权限。

remote_remote_error

远程实例回复 500 INTERNAL ERROR

remote_timeout

代理在分配的时间内未回复。

webhook_not_found

提供的 webhook uuid 不对应于实例中配置的任何 webhook。
© . This site is unofficial and not affiliated with Meilisearch.