如何让FastAPI在Docker容器中实现热重载功能？

问题分析 #

你通过卷挂载实现了本地代码与容器目录同步，但因缺少关键重载参数、重启策略冲突，导致文件变更后容器未自动更新服务。

配置修改 #

1. 更新Dockerfile

给uvicorn添加--reload参数，让其监听文件变更自动重启服务：

FROM python:3.8

RUN mkdir /server
WORKDIR /server

COPY requirements.txt ./
RUN pip install --no-cache-dir --upgrade -r requirements.txt

CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "80", "--reload"]

2. 调整docker-compose.yml

移除restart: always，避免该策略与uvicorn的重载机制冲突：

version: "3.5"

services:
  backend:
    container_name: backend
    ports:
      - '80:80'
    build:
      context: backend
      dockerfile: Dockerfile
    volumes:
      - ./backend:/server

验证步骤 #

1. 停止现有容器：docker-compose down
2. 重新构建启动：docker-compose up --build
3. 修改本地backend/main.py代码，查看容器日志会看到uvicorn检测到文件变更并重启服务，此时访问接口即可获取更新后的内容。

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