请查阅此页面,了解使用 Meilisearch API 时可能遇到的所有错误。
api_key_already_existsuid 的密钥。
api_key_not_foundbad_requestbatch_not_founduid。
database_size_limit_reacheddocument_fields_limit_reacheddocument_not_founddump_process_failedfacet_search_disabledfacetSearch 索引设置设置为 false 时,已查询 /facet-search 路由。
feature_not_enabledimmutable_api_key_actionsactions 字段不可修改。
immutable_api_key_created_atcreatedAt 字段不可修改。
immutable_api_key_expires_atexpiresAt 字段不可修改。
immutable_api_key_indexesindexes 字段不可修改。
immutable_api_key_keykey 字段不可修改。
immutable_api_key_uiduid 字段不可修改。
immutable_api_key_updated_atupdatedAt 字段不可修改。
immutable_index_uiduid 字段不可修改。
immutable_index_updated_atupdatedAt 字段不可修改。
immutable_webhookisEditable 设置为 true。使用实例选项创建的 webhook 也是不可变的。
immutable_webhook_uuiduuid。Meilisearch 会自动为 webhook 生成 uuid。
immutable_webhook_is_editableisEditable 字段。Meilisearch 会自动为所有 webhook 设置 isEditable。只有预留 webhook 的 isEditable 设置为 false。
index_already_existsuid 的索引,请查阅我们的 索引创建指南。
index_creation_failedindex_not_founduid 的索引,请查阅我们的 索引创建指南。
index_primary_key_already_existsindex_primary_key_multiple_candidates_foundid 结尾的字段。使用 更新索引端点 手动设置主键。
internalinvalid_api_keyinvalid_api_key_actionsactions 字段无效。它应该是一个表示操作名称的字符串数组。
invalid_api_key_descriptiondescription 字段无效。它应该是一个字符串或设置为 null。
invalid_api_key_expires_atexpiresAt 字段无效。它应该显示 RFC 3339 格式的未来日期或日期时间,或者设置为 null。
invalid_api_key_indexesindexes 字段无效。它应该是一个表示索引名称的字符串数组。
invalid_api_key_limitlimit 参数无效。它应该是一个整数。
invalid_api_key_namename 无效。它应该是一个字符串或设置为 null。
invalid_api_key_offsetoffset 参数无效。它应该是一个整数。
invalid_api_key_uiduid 无效。uid 必须遵循 uuid v4 格式。
invalid_search_attributes_to_search_onattributesToSearchOn 的值无效。attributesToSearchOn 接受一个字符串数组,表示文档属性。传递给 attributesToSearchOn 的属性必须存在于 searchableAttributes 列表中。
invalid_search_mediamedia 的值不是有效的 JSON 对象。
invalid_search_media_and_vectormedia 和 vector 的值都不是 null。这两个参数是互斥的,因为 media 通过 hybrid 中配置的嵌入器生成向量嵌入。
invalid_content_typeinvalid_document_csv_delimitercsvDelimiter 参数无效。它应该是一个字符串或 单个 ASCII 字符。
invalid_document_idinvalid_document_fieldsfields 参数无效。它应该是一个字符串。
invalid_document_filterfilter 参数无效
filterableAttributes 列表中定义invalid_document_limitlimit 参数无效。它应该是一个整数。
invalid_document_offsetoffset 参数无效。它应该是一个整数。
invalid_document_sortsort 参数的语法无效sortableAttributes 列表或 sort 排序规则中定义。_geo、_geoDistance、_geoRadius 或 _geoBoundingBox 之类的保留关键字被用作过滤器invalid_document_geo_field_geo 字段无效。Meilisearch 期望 _geo 是一个包含两个字段的对象,lat 和 lng,每个字段都包含表示为字符串或浮点数的地理坐标。在我们的专用指南中阅读有关 _geo 以及如何对其进行故障排除的更多信息。
invalid_export_urlinvalid_export_api_keyinvalid_export_payload_sizeinvalid_export_indexes_patternsinvalid_export_index_filterinvalid_facet_search_facet_namefacetName 字段的属性不是字符串或未在 filterableAttributes 列表中定义。
invalid_facet_search_facet_queryfacetQuery 提供的值无效。它应该是一个字符串或 null。
invalid_index_limitlimit 参数无效。它应该是一个整数。
invalid_index_offsetoffset 参数无效。它应该是一个整数。
invalid_index_uidinvalid_index_primary_keyprimaryKey 字段无效。它应该是一个字符串或设置为 null。
invalid_multi_search_query_federatedfederationOptions,但顶层 federation 对象为 null 或缺失。
invalid_multi_search_query_paginationpage、hitsPerPage、limit 或 offset,但顶层 federation 对象不为 null。
invalid_multi_search_query_positionfederationOptions.queryPosition 不是正整数。
invalid_multi_search_weightfederated.weight 的值为负数。
invalid_multi_search_queries_ranking_rulesinvalid_multi_search_facetsfederation.facetsByIndex.<INDEX_NAME> 包含不在可过滤属性列表中的值。
invalid_multi_search_sort_facet_values_byfederation.mergeFacets.sortFacetValuesBy 不是字符串或不包含允许值之一。
invalid_multi_search_query_facetsfacets,而 federation 存在且不为 null。
invalid_multi_search_merge_facetsfederation.mergeFacets 不是对象或包含意外字段。
invalid_multi_search_max_values_per_facetfederation.mergeFacets.maxValuesPerFacet 不是正整数。
invalid_multi_search_facet_orderfaceting.sortFacetValuesBy。
invalid_multi_search_facets_by_indexfacetsByIndex 不是对象或包含未知字段。
invalid_multi_search_remotefederationOptions.remote 既不是 network.self 也不是 network.remotes 中的键。
invalid_network_selfself,它不是字符串或 null。
invalid_network_remotesremotes,它不是对象或 null。
invalid_network_urlurl,它不是字符串。
invalid_network_search_api_keysearchApiKey,它不是字符串或 null。
invalid_search_attributes_to_cropattributesToCrop 参数无效。它应该是一个字符串数组、一个字符串或设置为 null。
invalid_search_attributes_to_highlightattributesToHighlight 参数无效。它应该是一个字符串数组、一个字符串或设置为 null。
invalid_search_attributes_to_retrieveattributesToRetrieve 参数无效。它应该是一个字符串数组、一个字符串或设置为 null。
invalid_search_crop_lengthcropLength 参数无效。它应该是一个整数。
invalid_search_crop_markercropMarker 参数无效。它应该是一个字符串或设置为 null。
invalid_search_embedderembedder 无效。它应该是一个与配置的嵌入器名称对应的字符串。
invalid_search_facetsfacets 参数无效。它应该是一个字符串数组、一个字符串或设置为 null。filterableAttributes 列表中定义。invalid_search_filterfilter 参数的语法无效。filterableAttributes 列表中定义_geo、_geoDistance 或 _geoPoint 之类的保留关键字被用作过滤器invalid_search_highlight_post_taghighlightPostTag 参数无效。它应该是一个字符串。
invalid_search_highlight_pre_taghighlightPreTag 参数无效。它应该是一个字符串。
invalid_search_hits_per_pagehitsPerPage 参数无效。它应该是一个整数。
invalid_search_hybrid_queryhybrid 参数既不是 null 也不是对象,或者它是一个包含未知键的对象。
invalid_search_limitlimit 参数无效。它应该是一个整数。
invalid_search_localeslocales 参数无效。
invalid_settings_embedderembedders 索引设置值无效。
invalid_settings_facet_searchfacetSearch 索引设置值无效。
invalid_settings_localized_attributeslocalizedAttributes 索引设置值无效。
invalid_search_matching_strategymatchingStrategy 参数无效。它应该设置为 last 或 all。
invalid_search_offsetoffset 参数无效。它应该是一个整数。
invalid_settings_prefix_searchprefixSearch 索引设置值无效。
invalid_search_pagepage 参数无效。它应该是一个整数。
invalid_search_qq 参数无效。它应该是一个字符串或设置为 null。
invalid_search_ranking_score_thresholdrankingScoreThreshold 不是介于 0.0 和 1.0 之间的数字。
invalid_search_show_matches_positionshowMatchesPosition 参数无效。它应该是一个布尔值或设置为 null。
invalid_search_sortsort 参数的语法无效sortableAttributes 列表或 sort 排序规则中定义。_geo、_geoDistance、_geoRadius 或 _geoBoundingBox 之类的保留关键字被用作过滤器invalid_settings_displayed_attributesnull。
invalid_settings_distinct_attributenull。
invalid_settings_faceting_sort_facet_values_bysortFacetValuesBy 对象提供的值不正确。接受的值为 alpha 或 count。
invalid_settings_faceting_max_values_per_facetmaxValuesPerFacet 字段的值无效。它应该是一个整数或设置为 null。
invalid_settings_filterable_attributesnull。
invalid_settings_paginationmaxTotalHits 字段的值无效。它应该是一个整数或设置为 null。
invalid_settings_ranking_rules_geo、_geoDistance、_geoRadius、_geoBoundingBox 或 _geoPoint 等保留关键字被用作自定义排序规则invalid_settings_searchable_attributesnull。
invalid_settings_search_cutoff_msinvalid_settings_sortable_attributesnull。
invalid_settings_stop_wordsnull。
invalid_settings_synonymsnull。
invalid_settings_typo_toleranceenabled 字段无效。它应该是一个布尔值或设置为 null。disableOnAttributes 字段无效。它应该是一个字符串数组或设置为 null。disableOnWords 字段无效。它应该是一个字符串数组或设置为 null。minWordSizeForTypos 字段无效。它应该是一个整数或设置为 null。oneTypo 或 twoTypos 的值无效。它应该是一个整数或设置为 null。invalid_similar_idnot_found_similar_idinvalid_similar_attributes_to_retrieveattributesToRetrieve 无效。它应该是一个字符串数组、一个字符串或设置为 null。
invalid_similar_embedderembedder 无效。它应该是一个与配置的嵌入器名称对应的字符串。
invalid_similar_filterfilter 无效或包含缺少或无效运算符的筛选器表达式。对于 POST 端点,筛选器表达式必须是字符串、字符串数组或字符串数组的数组。对于 GET 端点,它必须是字符串。 如果用于过滤的属性未在 filterableAttributes 列表中定义,Meilisearch 也会抛出此错误。invalid_similar_limitlimit 无效。它应该是一个整数。
invalid_similar_offsetoffset 无效。它应该是一个整数。
invalid_similar_show_ranking_scoreranking_score 无效。它应该是一个布尔值。
invalid_similar_show_ranking_score_detailsranking_score_details 无效。它应该是一个布尔值。
invalid_similar_ranking_score_thresholdrankingScoreThreshold 不是介于 0.0 和 1.0 之间的数字。
invalid_stateinvalid_store_filedata.ms 文件夹处于无效状态。您的 b 文件已损坏或 data.ms 文件夹已被文件替换。
invalid_swap_duplicate_index_foundindexes 数组中使用的索引已多次声明。您必须只声明每个索引一次。
invalid_swap_indexesinvalid_task_after_enqueued_atafterEnqueuedAt 查询参数无效。
invalid_task_after_finished_atafterFinishedAt 查询参数无效。
invalid_task_after_started_atafterStartedAt 查询参数无效。
invalid_task_before_enqueued_atbeforeEnqueuedAt 查询参数无效。
invalid_task_before_finished_atbeforeFinishedAt 查询参数无效。
invalid_task_before_started_atbeforeStartedAt 查询参数无效。
invalid_task_canceled_bycanceledBy 查询参数无效。它应该是一个整数。多个 uid 应使用逗号 (,) 分隔。
invalid_task_index_uidsindexUids 查询参数包含无效的索引 uid。
invalid_task_limitlimit 参数无效。它必须是一个整数。
invalid_task_statusesinvalid_task_typesinvalid_task_uidsuids 查询参数无效。
invalid_webhooksinvalid_webhook_urlnull,缺失,或其值无法解析为有效的 URL。
invalid_webhook_headersheaders 字段不是 JSON 对象或不是有效的 HTTP 标头。如果您为单个 webhook 设置超过 200 个标头字段,Meilisearch 也会返回此错误。
invalid_webhook_uuiduuid 不是有效的 uuid v4 值。
io_errorindex_primary_key_no_candidate_foundid 结尾的字段。手动指定主键,或向文档添加以 id 结尾的字段。
malformed_payloadmissing_api_key_actionsactions 字段。
missing_api_key_expires_atexpiresAt 字段。
missing_api_key_indexesindexes 字段。
missing_authorization_headerX-MEILI-API-KEY: apiKey,而 v0.25 及更高版本使用 Authorization: Bearer apiKey。missing_content_typemissing_document_filterfilter 字段。
missing_document_idmissing_index_uiduid 字段。
missing_facet_search_facet_namefacetName 参数。
missing_master_key/keys 路由。在我们的 安全教程中阅读有关启动时设置主密钥的更多信息。
missing_network_urlurl 字段。
missing_payloadmissing_swap_indexesindexes 对象。
missing_task_filtersno_space_left_on_devicenot_foundpayload_too_largetask_not_founduid。
too_many_open_filestoo_many_open_files 错误。在运行 Meilisearch 之前,请使用 ulimit 或类似工具来增加资源消耗限制。例如,在 UNIX 环境中调用 ulimit -Sn 3000 可将允许的文件描述符数量提高到 3000。
too_many_search_requests--experimental-search-queue-size 设置为更高的值来配置它。
unretrievable_documentvector_embedding_errorremote_bad_responseremote_bad_request400 BAD REQUEST。
remote_could_not_send_requestremote_invalid_api_key403 FORBIDDEN 或 401 UNAUTHORIZED。配置的搜索 API 密钥可能缺失、无效或缺少所需的搜索权限。
remote_remote_error500 INTERNAL ERROR。
remote_timeoutwebhook_not_founduuid 不对应于实例中配置的任何 webhook。