{
  "id": "pip/pep-517-build-backend-requires",
  "signature": "ERROR: Could not find a backend for building the project. The project uses a build backend that is not installed. Backend: 'setuptools.build_meta'",
  "signature_zh": "错误：找不到用于构建项目的后端。该项目使用的构建后端未安装。后端：'setuptools.build_meta'",
  "regex": "ERROR: Could not find a backend for building the project\\. The project uses a build backend that is not installed\\. Backend: '[^']+'",
  "domain": "pip",
  "category": "build_error",
  "subcategory": null,
  "root_cause": "The project's pyproject.toml specifies a build backend (e.g., setuptools.build_meta) that is not installed in the current environment, causing pip to fail before any package installation.",
  "root_cause_type": "generic",
  "root_cause_zh": "项目的 pyproject.toml 指定了构建后端（如 setuptools.build_meta），但当前环境中未安装该后端，导致 pip 在包安装前失败。",
  "versions": [
    {
      "version": "pip 23.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "pip 23.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "pip 23.2",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "setuptools 67.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "setuptools 68.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "This bypasses build isolation but still requires the backend to be installed; if setuptools is missing, it still fails.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "This flag ignores Python version constraints, not build backend requirements; irrelevant to the error.",
      "fail_rate": 1.0,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Removing pyproject.toml may cause pip to fall back to legacy build, but if setup.py is also missing or incompatible, it fails; also breaks modern packaging.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Install the missing backend explicitly: pip install setuptools wheel",
      "success_rate": 0.95,
      "how": "Install the missing backend explicitly: pip install setuptools wheel",
      "condition": "",
      "sources": []
    },
    {
      "action": "If using a different backend (e.g., flit_core): pip install flit_core",
      "success_rate": 0.9,
      "how": "If using a different backend (e.g., flit_core): pip install flit_core",
      "condition": "",
      "sources": []
    },
    {
      "action": "Create a virtual environment and reinstall: python -m venv venv && source venv/bin/activate && pip install --upgrade pip setuptools wheel",
      "success_rate": 0.85,
      "how": "Create a virtual environment and reinstall: python -m venv venv && source venv/bin/activate && pip install --upgrade pip setuptools wheel",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Install the missing backend explicitly: pip install setuptools wheel",
    "If using a different backend (e.g., flit_core): pip install flit_core",
    "Create a virtual environment and reinstall: python -m venv venv && source venv/bin/activate && pip install --upgrade pip setuptools wheel"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://pip.pypa.io/en/stable/reference/build-system/",
  "official_doc_section": null,
  "error_code": "ERROR",
  "verification_tier": "ai_generated",
  "confidence": 0.88,
  "fix_success_rate": 0.85,
  "resolvable": "true",
  "first_seen": "2023-06-15",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}