python
install_error
ai_generated
true
错误：somepkg-1.0-cp312-cp312-manylinux_2_28_x86_64.whl 在此平台上不受支持。
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
80%修复率
87%置信度
0证据数
2025-06-30首次发现
版本兼容性
| 版本 | 状态 | 引入 | 弃用 | 备注 |
|---|---|---|---|---|
| 3.8 | active | — | — | — |
| 3.9 | active | — | — | — |
| 3.10 | active | — | — | — |
| 3.11 | active | — | — | — |
| 3.12 | active | — | — | — |
根因分析
该 wheel 的平台标签（如 manylinux_2_28）要求比主机更新的 glibc，或者架构/ABI 不匹配。
English
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.
解决方案
-
90% 成功率
python -c "from packaging.tags import sys_tags; print([str(t) for t in sys_tags()][:10])"
-
75% 成功率
pip install --no-binary=:all: <package> # or pip install <package>==<older-version>
-
80% 成功率
docker run --rm -it python:3.12-slim # build inside a matching container
无效尝试
常见但无效的做法:
-
90% 失败
The binary still links against newer symbols and fails at import time with undefined symbols.
-
95% 失败
Force-reinstall does not bypass platform-tag validation.
-
95% 失败
The wheel itself is rejected regardless of dependencies.