{
  "id": "mongodb/atlas-search-index-sync-failure",
  "signature": "MongoDB Atlas Search index sync failed: Index 'search_idx' on collection 'products' in sync state 'FAILED'",
  "signature_zh": "MongoDB Atlas Search 索引同步失败：集合 'products' 上的索引 'search_idx' 处于同步状态 'FAILED'",
  "regex": "Atlas Search index sync failed.*sync state 'FAILED'",
  "domain": "mongodb",
  "category": "config_error",
  "subcategory": null,
  "root_cause": "An Atlas Search index definition contains an invalid mapping (e.g., referencing a non-existent field, using an unsupported analyzer, or exceeding field limit), causing the index synchronization process to fail.",
  "root_cause_type": "generic",
  "root_cause_zh": "Atlas Search 索引定义包含无效映射（例如引用不存在的字段、使用不支持的解析器或超出字段限制），导致索引同步过程失败。",
  "versions": [
    {
      "version": "MongoDB Atlas (M10+ clusters)",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Atlas Search 1.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Atlas Search 2.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "The underlying mapping error persists; the new index will also fail to sync.",
      "fail_rate": 0.95,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "The failure is due to schema validation, not resource constraints.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Atlas Search sync is asynchronous and does not re-validate the index definition on document insertion.",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Check the Atlas UI for detailed error messages in the Search Index details panel. Common fixes: remove unsupported field types (e.g., arrays of mixed types) or correct analyzer names (e.g., 'lucene.standard' instead of 'standard').",
      "success_rate": 0.85,
      "how": "Check the Atlas UI for detailed error messages in the Search Index details panel. Common fixes: remove unsupported field types (e.g., arrays of mixed types) or correct analyzer names (e.g., 'lucene.standard' instead of 'standard').",
      "condition": "",
      "sources": []
    },
    {
      "action": "Use the Atlas Search API to retrieve the index status: `curl -s -u \"username:apiKey\" \"https://cloud.mongodb.com/api/atlas/v1.0/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}\" | jq '.status'`. Then update the index definition with corrected mappings.",
      "success_rate": 0.8,
      "how": "Use the Atlas Search API to retrieve the index status: `curl -s -u \"username:apiKey\" \"https://cloud.mongodb.com/api/atlas/v1.0/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}\" | jq '.status'`. Then update the index definition with corrected mappings.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Simplify the index definition to only include essential fields, then gradually add fields while monitoring sync status.",
      "success_rate": 0.75,
      "how": "Simplify the index definition to only include essential fields, then gradually add fields while monitoring sync status.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "在 Atlas UI 的搜索索引详情面板中检查详细错误消息。常见修复：删除不支持的字段类型（例如混合类型的数组）或更正解析器名称（例如使用 'lucene.standard' 而不是 'standard'）。",
    "使用 Atlas Search API 检索索引状态：`curl -s -u \"username:apiKey\" \"https://cloud.mongodb.com/api/atlas/v1.0/groups/{groupId}/clusters/{clusterName}/fts/indexes/{indexId}\" | jq '.status'`。然后使用更正后的映射更新索引定义。",
    "简化索引定义，只包含必要字段，然后逐步添加字段并监控同步状态。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://www.mongodb.com/docs/atlas/atlas-search/create-index/",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.83,
  "fix_success_rate": 0.8,
  "resolvable": "true",
  "first_seen": "2024-05-12",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}