FastAPI应用能否实现多阶段Docker构建？求助配置问题

问题概述 #

为基础CRUD的FastAPI应用编写了单阶段Dockerfile，尝试通过多阶段构建（Dockerfile.dev）减小镜像体积，但第二阶段无法识别index.py文件，需确认方案可行性、正确构建方法及Entrypoint设置。

一、方案可行性 #

多阶段构建完全可行，核心优势是拆分依赖安装与代码部署流程，仅将运行时必需的内容复制到最终镜像，有效减少冗余文件（如构建阶段的临时安装包、编译缓存等），从而降低镜像体积。

二、正确的多阶段构建配置 #

当前Dockerfile.dev的问题在于未设置运行阶段的工作目录，且依赖复制逻辑不合理，以下是修正后的配置：

# 第一阶段：构建依赖与复制代码
FROM python:3.9-slim as BUILD
ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1
WORKDIR /app

# 复制依赖清单并安装到用户目录（便于后续复制）
COPY requirements.txt .
RUN pip install --user -r requirements.txt

# 复制完整应用代码
COPY . .

# 第二阶段：运行时镜像
FROM python:3.9-slim
ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1
WORKDIR /app

# 安装运行时必需的系统依赖（wait-for.sh依赖netcat，mysql-client按需保留）
RUN apt-get update && apt-get install -y --no-install-recommends netcat-traditional default-mysql-client \
    && rm -rf /var/lib/apt/lists/*

# 从构建阶段复制Python依赖到系统目录
COPY --from=BUILD /root/.local/lib/python3.9/site-packages /usr/local/lib/python3.9/site-packages
COPY --from=BUILD /root/.local/bin /usr/local/bin

# 从构建阶段复制应用代码与脚本
COPY --from=BUILD /app/ .

# 赋予脚本执行权限
RUN chmod +x wait-for.sh

EXPOSE 8000
CMD ["uvicorn", "index:app", "--reload", "--host", "0.0.0.0", "--port", "8000"]

关键修正点： #

• 工作目录统一：运行阶段明确设置WORKDIR /app，确保代码文件与脚本都在预期路径下，避免uvicorn找不到index.py。
• 依赖分离安装：构建阶段用--user将Python依赖安装到用户目录，仅复制必要的依赖文件到运行阶段，减少镜像体积。
• 系统依赖按需安装：运行阶段仅安装必需的系统工具，避免携带构建阶段的冗余依赖。

三、Entrypoint设置 #

当前docker-compose.yml中的Entrypoint配置逻辑正确，实现了等待MySQL服务启动后再启动FastAPI的功能，无需修改：

entrypoint: [ "./wait-for.sh", "db:3306", "--", "uvicorn", "index:app", "--reload", "--host", "0.0.0.0", "--port", "8000" ]

注意事项： #

• --reload仅适用于开发环境，生产环境建议移除，避免性能损耗。
• 确保wait-for.sh位于WORKDIR /app下，与Dockerfile中的复制逻辑匹配。

内容的提问来源于stack exchange，提问作者Arafat Hossain Rifat