请查阅此页面,了解使用 Meilisearch API 时可能遇到的所有错误。
api_key_already_exists
uid
的密钥。
api_key_not_found
bad_request
batch_not_found
uid
。
database_size_limit_reached
document_fields_limit_reached
document_not_found
dump_process_failed
facet_search_disabled
facetSearch
索引设置设置为 false
时,已查询 /facet-search
路由。
feature_not_enabled
immutable_api_key_actions
actions
字段不可修改。
immutable_api_key_created_at
createdAt
字段不可修改。
immutable_api_key_expires_at
expiresAt
字段不可修改。
immutable_api_key_indexes
indexes
字段不可修改。
immutable_api_key_key
key
字段不可修改。
immutable_api_key_uid
uid
字段不可修改。
immutable_api_key_updated_at
updatedAt
字段不可修改。
immutable_index_uid
uid
字段不可修改。
immutable_index_updated_at
updatedAt
字段不可修改。
immutable_webhook
isEditable
设置为 true
。使用实例选项创建的 webhook 也是不可变的。
immutable_webhook_uuid
uuid
。Meilisearch 会自动为 webhook 生成 uuid
。
immutable_webhook_is_editable
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
invalid_api_key
invalid_api_key_actions
actions
字段无效。它应该是一个表示操作名称的字符串数组。
invalid_api_key_description
description
字段无效。它应该是一个字符串或设置为 null
。
invalid_api_key_expires_at
expiresAt
字段无效。它应该显示 RFC 3339 格式的未来日期或日期时间,或者设置为 null
。
invalid_api_key_indexes
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
media
和 vector
的值都不是 null
。这两个参数是互斥的,因为 media
通过 hybrid
中配置的嵌入器生成向量嵌入。
invalid_content_type
invalid_document_csv_delimiter
csvDelimiter
参数无效。它应该是一个字符串或 单个 ASCII 字符。
invalid_document_id
invalid_document_fields
fields
参数无效。它应该是一个字符串。
invalid_document_filter
filter
参数无效
filterableAttributes
列表中定义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
是一个包含两个字段的对象,lat
和 lng
,每个字段都包含表示为字符串或浮点数的地理坐标。在我们的专用指南中阅读有关 _geo
以及如何对其进行故障排除的更多信息。
invalid_export_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
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
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
。oneTypo
或 twoTypos
的值无效。它应该是一个整数或设置为 null
。invalid_similar_id
not_found_similar_id
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
查询参数无效。
invalid_webhooks
invalid_webhook_url
null
,缺失,或其值无法解析为有效的 URL。
invalid_webhook_headers
headers
字段不是 JSON 对象或不是有效的 HTTP 标头。如果您为单个 webhook 设置超过 200 个标头字段,Meilisearch 也会返回此错误。
invalid_webhook_uuid
uuid
不是有效的 uuid v4 值。
io_error
index_primary_key_no_candidate_found
id
结尾的字段。手动指定主键,或向文档添加以 id
结尾的字段。
malformed_payload
missing_api_key_actions
actions
字段。
missing_api_key_expires_at
expiresAt
字段。
missing_api_key_indexes
indexes
字段。
missing_authorization_header
X-MEILI-API-KEY: apiKey
,而 v0.25 及更高版本使用 Authorization: Bearer apiKey
。missing_content_type
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
missing_swap_indexes
indexes
对象。
missing_task_filters
no_space_left_on_device
not_found
payload_too_large
task_not_found
uid
。
too_many_open_files
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
webhook_not_found
uuid
不对应于实例中配置的任何 webhook。