Python3.7+多阶段Docker构建含mysqlclient的Flask轻量镜像报错求解

问题根因 #

• 你使用的--static参数仅会让mysqlclient静态链接libmysqlclient库，但libmysqlclient本身依赖的OpenSSL加密库、zlib压缩库仍为动态链接，生成的.so扩展文件运行时需要依赖系统对应版本的动态库
• Python 3.6 slim镜像基于Debian 9（Stretch），编译阶段和最终运行阶段的系统依赖版本完全一致，动态链接可以正常找到对应符号；Python 3.7+ slim镜像基于Debian 10（Buster）及以上版本，要么是编译时链接的OpenSSL版本和最终运行镜像的版本不匹配，要么是最终slim镜像默认没有预装libssl、zlib等运行时库，就会出现TLS_client_method符号找不到的报错

修复方案 #

方案1：补全最终镜像的轻量运行时依赖（最便捷，增量体积<5MB） #

不需要安装体积庞大的编译依赖和dev包，仅安装运行时需要的基础库即可，修改最终阶段的Dockerfile：

FROM python:3.7-slim

COPY --from=builder /build /build

# 新增：安装最小运行时依赖，清理缓存控制体积
RUN apt update && apt install -y --no-install-recommends libssl1.1 zlib1g \
    && rm -rf /var/lib/apt/lists/* \
    && pip install --find-links=/build app

CMD ["flask", "run"]

方案2：修改编译参数实现完全静态链接 #

修改builder阶段的mysqlclient编译指令，强制把所有依赖库静态链接到扩展文件中，不需要修改最终镜像：

# 替换原来的setup.py编译行
RUN LDFLAGS="-static-libgcc -static-libstdc++ -lssl -lcrypto -lz" python /build/mysqlclient-python/setup.py --static bdist_wheel && mv ./dist/*.whl /build

方案3：替换为纯Python MySQL驱动（零系统依赖，体积最小） #

直接换用pymysql，不需要任何编译步骤和系统依赖，仅需修改项目依赖和SQLAlchemy连接串（在连接地址后加?charset=utf8mb4&pymysql后缀即可），完全不需要处理编译相关的问题。

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