如何在多阶段构建Dockerfile中跨阶段复制Flask依赖 解决libmariadb缺失报错

当前启动报错的核心原因是跨阶段复制仅迁移了Python层面的依赖，没有覆盖C扩展运行所需的系统级动态库依赖：

• 单阶段版本能正常运行，是因为镜像同时安装了mariadb-dev开发包（包含编译用的头文件、开发工具）和运行时所需的libmariadb.so.3动态共享库，编译完成的MySQLdb C扩展可以直接加载到运行环境。
• 修改为多阶段构建后，所有编译工具链、开发包都被留在了builder阶段，最终运行镜像中没有任何Mariadb相关的动态库文件，哪怕完整复制了编译好的MySQLdb Python包，加载C扩展时依然会因为找不到系统依赖报错。

核心思路是完全分离编译依赖和运行依赖：builder阶段只保留编译Python包所需的工具链和开发头文件；最终运行阶段只安装最小化的运行时动态库依赖，再从builder阶段复制已经编译完成的Python包。

关键配置调整点 #

• builder阶段保留原有逻辑：安装编译工具链、Mariadb开发头文件，通过pip install --user把Python依赖安装到/root/.local目录，方便后续跨阶段复制，这部分无需改动。
• 运行阶段单独安装Alpine源中提供纯运行时动态库的mariadb-connector-c包，这个包不包含gcc、头文件等编译工具内容，体积极小，刚好满足MySQLdb的动态库加载需求。
• 补全运行阶段的基础配置：设置正确的工作目录、统一服务端口配置、添加对应的端口暴露声明。

修正后的完整Dockerfile #

# 第一阶段：构建环境，仅负责编译Python依赖
FROM python:3.8-alpine as builder
WORKDIR /build

# 安装编译所需的工具链和Mariadb开发头文件
RUN apk update \
    && apk add --virtual build-deps gcc python3-dev musl-dev \
    && apk add --no-cache mariadb-dev

# 先复制依赖清单，充分利用Docker构建缓存
COPY ./myapp/requirements.txt requirements.txt
# 将Python依赖安装到用户目录，便于后续跨阶段迁移
RUN pip install --user --no-cache-dir -r requirements.txt

# 第二阶段：运行环境，仅保留最小化运行依赖
FROM python:3.8-alpine
WORKDIR /code

# 安装C扩展运行所需的最小动态库依赖（无编译工具，体积开销极低）
RUN apk add --no-cache mariadb-connector-c

# 从构建阶段复制已编译完成的Python依赖
COPY --from=builder /root/.local /root/.local
# 将用户目录下的Python可执行文件、库路径加入系统PATH
ENV PATH=/root/.local/bin:$PATH

# 复制应用代码
COPY ./myapp .

# 配置Flask运行参数
ENV FLASK_APP=App.py
ENV FLASK_RUN_HOST=0.0.0.0
ENV FLASK_RUN_PORT=3001
EXPOSE 3001

# 启动服务
CMD ["python", "-m", "flask", "run"]

• 多阶段构建不是只要把builder阶段的文件复制到运行镜像就结束，带C扩展的Python包必须在运行阶段单独安装对应的系统动态库依赖。这类依赖不属于Python包的管辖范围，不会被pip自动打包，更不会通过Docker的COPY指令自动迁移。
• 不要直接把builder阶段的mariadb-dev包复制到运行镜像中，这类开发包包含的头文件、静态库体积很大，完全没必要在运行环境保留，只需要安装提供动态库的轻量运行包即可。

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