安装TF2 Classic执行TF2CDownloader报GLIBC_2.30缺失错误

错误现象 #

运行TF2CDownloader安装TF2 Classic时程序直接退出，抛出如下错误：

[1914] Error loading Python lib '/tmp/_MEImSAQlR/libpython3.10.so.1.0': dlopen:
/lib/x86_64-linux-gnu/libpthread.so.0: version `GLIBC_2.30' not found (required by /tmp/_MEImSAQlR/libpython3.10.so.1.0)

根因说明 #

TF2CDownloader是通过PyInstaller打包的单文件二进制，包内内置了Python 3.10运行时，这个运行时编译时依赖GLIBC 2.30及以上版本。当前系统的GLIBC版本低于2.30，libpthread.so.0动态库缺少对应版本的符号，导致内置Python库加载失败。

排查步骤 #

• 执行ldd --version，查看输出首行的GLIBC版本号，确认版本确实低于2.30（常见低版本场景：Ubuntu 18.04自带GLIBC 2.27、Debian 10自带GLIBC 2.28，均不满足要求）
• 执行uname -m确认系统架构为x86_64，排除架构不匹配导致的异常报错

解决方案 #

按稳定性优先级排序：

• 升级系统发行版版本（推荐）
  升级到自带GLIBC≥2.30的系统版本即可直接运行官方打包的下载器，比如Ubuntu 20.04及以上（自带GLIBC 2.31）、Debian 11及以上（自带GLIBC 2.31）。禁止手动单独升级系统GLIBC包，该操作会破坏系统核心依赖链，大概率导致系统无法正常启动。
• 直接运行下载器源码
  不想升级系统的话可以直接运行源码版本，会调用系统自带的Python和动态库，不会触发打包版本的GLIBC版本要求：
  1. 先安装系统依赖：Python 3.8+、git、pip3
  2. 拉取TF2CDownloader源码到本地
  3. 进入源码目录执行pip3 install -r requirements.txt安装Python依赖
  4. 执行python3 tf2cdownloader.py即可正常启动下载流程
• 容器隔离运行
  熟悉容器操作的话，可以用Ubuntu 22.04等带高版本GLIBC的基础镜像启动容器，将游戏下载目录挂载到容器内，在容器中运行官方打包的TF2CDownloader，下载完成的文件会直接存到宿主机挂载目录，不会修改宿主机系统依赖。

内容的提问来源于stack exchange，提问作者gr3nax