{
  "id": "python/pip-cache-corruption-invalid-wheel",
  "signature": "ERROR: Wheel 'numpy-1.26.4-cp311-cp311-manylinux_2_17_x86_64.whl' is invalid: error in <pkg> METADATA: invalid zip file",
  "signature_zh": "错误：Wheel 'numpy-1.26.4-cp311-cp311-manylinux_2_17_x86_64.whl' 无效：<pkg> METADATA 错误：zip 文件无效。",
  "regex": "ERROR:\\ Wheel\\ 'numpy\\-1\\.26\\.4\\-cp311\\-cp311\\-manylinux_2_17_x86_64\\.whl'\\ is\\ invalid:\\ error\\ in\\ <pkg>\\ METADATA:\\ invalid\\ zip\\ file",
  "domain": "python",
  "category": "data_error",
  "subcategory": null,
  "root_cause": "A previously downloaded wheel in the pip cache is truncated or corrupted, and pip reuses it without re-validating the zip structure.",
  "root_cause_type": "generic",
  "root_cause_zh": "pip 缓存中先前下载的 wheel 被截断或损坏，pip 复用时未重新校验 zip 结构。",
  "versions": [
    {
      "version": "3.8",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.9",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.10",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.11",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "3.12",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Disables index lookup entirely, so pip cannot refetch the corrupted wheel.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Force-reinstall still consults the cache and can reuse the same corrupted file.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "",
      "success_rate": 0.95,
      "how": "Purge the cache and reinstall: `pip cache purge && pip install --no-cache-dir <pkg>`.",
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "success_rate": 0.92,
      "how": "Inspect and remove the specific cached wheel: `pip cache list <pkg>` then `pip cache remove <pkg>`.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": null,
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.88,
  "fix_success_rate": 0.8,
  "resolvable": "true",
  "first_seen": "2024-11-21",
  "last_confirmed": "2025-01-01",
  "last_updated": "2025-01-01",
  "evidence_count": 0,
  "tags": [],
  "locale": "en",
  "aliases": []
}