Docker CentOS环境SQLAlchemy连接MySQL报NameError: _mysql未定义

• 核心触发点是报错栈中的ImportError: /lib64/libstdc++.so.6: cannot allocate memory in static TLS block，该错误是CentOS最新版本的系统libstdc++库与pip编译安装的mysqlclient（MySQLdb底层依赖的C扩展）存在兼容性问题：动态加载_mysql扩展模块时，系统预分配的静态TLS（线程局部存储）内存块不足，导致扩展加载失败。
• 后续的NameError: name '_mysql' is not defined是衍生错误：由于_mysql模块导入失败，MySQLdb初始化时引用该变量就会抛出未定义错误。

以下方案按实施复杂度从低到高排列：

方案1：预加载libstdc++库（最快生效，无需修改代码/依赖） #

在Dockerfile中添加环境变量强制预加载libstdc++.so.6即可解决TLS分配不足的问题，在你的Dockerfile的WORKDIR行之后添加以下内容：

ENV LD_PRELOAD=/lib64/libstdc++.so.6

也可以在启动容器时直接指定环境变量：

docker run -e LD_PRELOAD=/lib64/libstdc++.so.6 你的镜像名

方案2：替换为纯Python实现的MySQL驱动（兼容性最优，无系统依赖） #

放弃依赖C扩展的mysqlclient，改用纯Python实现的pymysql驱动，不需要依赖系统的MySQL开发库，也不会触发动态链接兼容性问题：

1. 修改requirements.txt，将mysqlclient替换为pymysql
2. 修改数据库连接字符串，将前缀mysql://改为mysql+pymysql://，修改后的代码如下：

mysql_conn = "mysql+pymysql://%s:%s@%s:%s/%s?charset=utf8"
engine = create_engine(mysql_conn % ("user", "passwd", "mysql", 3306, "host"))

3. 重新构建镜像即可生效。

方案3：更换稳定版基础镜像 #

你当前使用的centos:latest对应滚动更新的CentOS Stream版本，稳定性较低，可替换为兼容RHEL的稳定发行版镜像，比如centos:7、almalinux:8，后续按原逻辑构建镜像即可规避版本兼容性问题。

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