python install_error ai_generated true

ERROR: somepkg-1.0-cp312-cp312-manylinux_2_28_x86_64.whl is not a supported wheel on this platform.

ID: python/pip-unsupported-wheel-tag

Also available as: JSON · Markdown · 中文
80%Fix Rate
87%Confidence
0Evidence
2025-06-30First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
3.8 active — — —
3.9 active — — —
3.10 active — — —
3.11 active — — —
3.12 active — — —

Root Cause

The wheel's platform tag (e.g., manylinux_2_28) requires a newer glibc than the host provides, or the architecture/ABI does not match.

generic

中文

该 wheel 的平台标签（如 manylinux_2_28）要求比主机更新的 glibc，或者架构/ABI 不匹配。

Workarounds

  1. 90% success 
    python -c "from packaging.tags import sys_tags; print([str(t) for t in sys_tags()][:10])"
  2. 75% success 
    pip install --no-binary=:all: <package>  # or pip install <package>==<older-version>
  3. 80% success 
    docker run --rm -it python:3.12-slim  # build inside a matching container

Dead Ends

Common approaches that don't work:

  1. 90% fail

    The binary still links against newer symbols and fails at import time with undefined symbols.

  2. 95% fail

    Force-reinstall does not bypass platform-tag validation.

  3. 95% fail

    The wheel itself is rejected regardless of dependencies.