在 ARMv7 设备上安装第三方非官方 wheel 包，弹出 version `GLIBC_2.28' not found 报错，本质就是这个 wheel 包是在 GLIBC 2.28 及更高版本的系统上编译出来的，而你当前 ARMv7 板子的系统自带 GLIBC 版本更低，底层 ABI 接口对不上，这个问题不是升级 pip、换虚拟环境、升级 Python 就能修好的，GLIBC 是操作系统核心底层库，不能随便替换覆盖。你可以先通过命令确认当前系统 GLIBC 版本、架构信息，再从找兼容旧版 wheel、源码编译、升级系统这几个方案里选适合自己设备的方式处理，优先选择不用改动系统底层的方案，避免系统变砖。
一、先执行检查命令，确认环境信息
- 查看 GLIBC 版本
ldd --version
- 确认设备架构，区分 ARMv7 和 aarch64（两者不能混用 wheel）
uname -m
- 查看 wheel 里面依赖的 GLIBC 符号
objdump -p xxx.so | grep GLIBC
说明：xxx.so 就是 wheel 包里面的动态库文件，用来确认是不是确实依赖 GLIBC_2.28 符号
二、4 套可用解决方案（按推荐优先级排序）
| 方案 | 操作说明 | 优点 | 风险 |
|---|---|---|---|
| 方案 1：更换适配低 GLIBC 的 ARMv7 wheel | 寻找 manylinux2014（GLIBC2.17）、piwheels 这类专门给树莓派 ARMv7 打包的兼容 wheel，不要用网上随便下载的非官方编译包 | 操作最简单，不改动系统 | 部分新版本包没有旧版兼容 wheel |
| 方案 2：源码编译安装 | 直接下载源码包（sdist），在当前 ARMv7 设备本地编译，编译出来的库自动适配本机 GLIBC | 兼容性最好 | 编译耗时久，需要 gcc、cmake 等编译依赖 |
| 方案 3：升级操作系统到自带 GLIBC≥2.28 的版本 | 更换支持 ARMv7 的新版系统，系统自带 GLIBC2.28+ | 一劳永逸，后续新包不容易报同类错 | 部分老 ARMv7 硬件没有新版系统支持 |
| 方案 4：容器隔离运行 | 用和 wheel 编译环境一致的 manylinux_2_28 ARMv7 容器，在容器内跑程序 | 不污染宿主机系统 | 需要硬件支持 docker，ARMv7 容器镜像资源偏少 |
三、一定要避开的高危操作清单
- ❌ 不要直接下载高版本 libc.so.6 覆盖系统文件，极易导致系统崩溃、ssh 连不上、设备变砖
- ❌ 不要把 aarch64（64 位 ARM）的 wheel 放到 ARMv7 32 位设备上使用，架构本身不兼容
- ❌ 不要尝试单独升级 libstdc++ 来解决 GLIBC 报错，GLIBC 和 GLIBCXX 是两套独立符号
- ❌ 不要迷信网上通用 x86 的 glibc-all-in-one 脚本，大多不支持 ARMv7 架构
四、快速验证修复是否成功
处理完成后，直接导入对应包测试：
import torch
或者对应你安装的库，没有再弹出 GLIBC_2.28 缺失提示，代表 ABI 匹配成功。
【相关 FAQ】
问题 1：ARMv7 非官方 wheel 报 GLIBC_2.28 not found，升级 pip 能不能解决 ABI 不匹配？
回答 1：ARMv7 非官方 wheel 出现 GLIBC_2.28 not found 属于底层 ABI 不匹配，升级 pip 只是包管理工具更新，不会修改系统 GLIBC 库，所以无法解决这个报错。
问题 2：ARMv7 设备上，piwheels 的 wheel 可以规避 GLIBC_2.28 ABI 不匹配问题吗？
回答 2：piwheels 专门为树莓派 ARMv7 编译 wheel，大多基于 manylinux2014，依赖 GLIBC 2.17，在旧 GLIBC 的 ARMv7 板子上可以避开 GLIBC_2.28 的 ABI 不匹配报错。
问题 3：ARMv7 和 aarch64 的 wheel 会出现 GLIBC_2.28 ABI 不匹配的互通问题吗？
回答 3：会，ARMv7 是 32 位 ARM、aarch64 是 64 位 ARM，指令集不一样，就算 GLIBC 版本相同，跨架构混用 wheel 依然会 ABI 不匹配，不能互相通用。
问题 4：ARMv7 源码编译 wheel，还会出现 GLIBC_2.28 not found 吗？
回答 4：ARMv7 本地源码编译生成的库，编译时会绑定本机当前 GLIBC 版本，只要不在别的更高 GLIBC 环境编译，就不会出现 GLIBC_2.28 not found 的 ABI 不匹配报错。
【参考资料】
[2026-11-09]（version `GLIBC_2.28' not found：ARMv7 非官方 wheel 与系统 ABI 不匹配）阿里云开发者社区
[2025-02-01]（PEP 600 – Future ‘manylinux’ Platform Tags for Portable Linux Built Distributions）Python 官方 PEP 文档
[2024-12-11]（PyTorch Linux Wheels switching to new wheel build platform: manylinux-2.28）PyTorch 开发者社区
【免责声明】
本文关于 ARMv7 非官方 wheel、GLIBC_2.28、ABI 不匹配的方案仅为技术排查参考；修改系统 GLIBC、刷机、编译操作存在设备损坏风险，请自行评估硬件环境；不同 ARMv7 硬件、发行版的内核、系统源存在差异，部分方案不一定适配全部设备，操作前建议做好数据备份。