Docker部署FastAPI无法自动重载代码，需手动重启容器求助

核心排查与修复步骤 #

1. 对齐卷挂载与容器工作目录 #

先检查backend目录下的Dockerfile中WORKDIR的设置：

• 若Dockerfile指定WORKDIR /app/backend，当前卷挂载./backend/:/app/backend是匹配的；
• 若Dockerfile设置WORKDIR /app，需调整卷挂载为./backend/:/app，同时修改uvicorn启动命令为uvicorn main:app --host 0.0.0.0 --reload（前提是本地main.py在./backend根目录），或根据实际目录结构调整模块路径（如uvicorn backend.main:app）。

2. 显式指定Uvicorn监听目录 #

Docker环境下文件系统事件传递可能存在延迟，给uvicorn添加--reload-dir参数强制指定监听目录：

command: "uvicorn main:app --host 0.0.0.0 --reload --reload-dir /app/backend"

（路径需与容器内代码目录完全匹配）

3. 修正环境变量格式错误 #

你的docker-compose环境变量定义存在多余空格，会导致变量值异常，修正为：

environment:
  - SECRET_KEY=${SECRET_KEY}
  - ALGORITHM=${ALGORITHM}
  - ACCESS_TOKEN_EXPIRE_MINUTES=${ACCESS_TOKEN_EXPIRE_MINUTES}

4. 验证文件同步状态 #

进入容器确认本地修改是否同步到容器内：

docker-compose exec api bash
# 执行后查看容器内代码目录（如/app/backend）的文件内容，确认与本地一致

若文件未同步，检查卷挂载路径拼写，或确保Docker Desktop的文件共享功能已开启且项目目录在共享范围内（针对Windows/macOS用户）。

5. 优化跨平台文件系统兼容性（Windows/macOS专属） #

这类系统上Docker的inotify事件传递可能失效，可尝试：

• 开启Docker Desktop的「文件共享」功能，并将项目目录加入共享列表；
• 给uvicorn命令添加--reload-inotify参数（部分版本支持）；
• 可选使用docker-sync工具提升文件同步效率。

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