{
  "id": "pip/pep-517-build-backend-missing",
  "signature": "ERROR: Could not find a version that satisfies the requirement setuptools>=40.8.0 (from pyproject.toml build-system.requires)",
  "signature_zh": "错误：找不到满足 pyproject.toml 构建系统要求中 setuptools>=40.8.0 的版本",
  "regex": "ERROR: Could not find a version that satisfies the requirement .+ \\(from pyproject\\.toml build-system\\.requires\\)",
  "domain": "pip",
  "category": "build_error",
  "subcategory": null,
  "root_cause": "The project's pyproject.toml specifies a build backend (e.g., setuptools) with a version constraint, but pip cannot find any version of that backend in the available indexes, often because the index is unreachable or the package name is misspelled.",
  "root_cause_type": "generic",
  "root_cause_zh": "项目的 pyproject.toml 指定了一个构建后端（例如 setuptools）及其版本约束，但 pip 在可用索引中找不到该后端的任何版本，通常是因为索引不可达或包名拼写错误。",
  "versions": [
    {
      "version": "pip 23.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "pip 24.1",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "pip 24.3",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Install the build backend manually before running pip install",
      "why_fails": "pip checks the build backend requirement during the build process and still fails because it tries to satisfy the constraint from pyproject.toml, even if the package is already installed.",
      "fail_rate": 0.7,
      "condition": "",
      "sources": []
    },
    {
      "action": "Remove the build-system section from pyproject.toml entirely",
      "why_fails": "This may cause pip to fall back to legacy setup.py, but if the project relies on PEP 517 features, the build may fail with a different error like 'Missing build backend'.",
      "fail_rate": 0.5,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Ensure the index URL is accessible and contains the required backend: pip install --index-url https://pypi.org/simple setuptools>=40.8.0",
      "success_rate": 0.85,
      "how": "Ensure the index URL is accessible and contains the required backend: pip install --index-url https://pypi.org/simple setuptools>=40.8.0",
      "condition": "",
      "sources": []
    },
    {
      "action": "Specify a custom index or extra index URL in pyproject.toml or via PIP_EXTRA_INDEX_URL if the backend is hosted on a private index.",
      "success_rate": 0.75,
      "how": "Specify a custom index or extra index URL in pyproject.toml or via PIP_EXTRA_INDEX_URL if the backend is hosted on a private index.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Downgrade pip to a version that supports legacy setup.py installation if the project is simple: pip install pip==21.3.1 && pip install <package>",
      "success_rate": 0.6,
      "how": "Downgrade pip to a version that supports legacy setup.py installation if the project is simple: pip install pip==21.3.1 && pip install <package>",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "确保索引 URL 可访问且包含所需后端：pip install --index-url https://pypi.org/simple setuptools>=40.8.0",
    "在 pyproject.toml 中指定自定义索引或通过 PIP_EXTRA_INDEX_URL 指定额外索引 URL，如果后端托管在私有索引上。",
    "如果项目简单，降级 pip 以支持传统的 setup.py 安装：pip install pip==21.3.1 && pip install <package>"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://pip.pypa.io/en/stable/topics/build-system/",
  "official_doc_section": null,
  "error_code": "ERROR",
  "verification_tier": "ai_generated",
  "confidence": 0.87,
  "fix_success_rate": 0.85,
  "resolvable": "true",
  "first_seen": "2023-06-05",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}