Docker环境Gunicorn运行Flask应用热重载不生效问题

热重载失效是两个核心配置错误叠加导致的：

• 代码目录未做挂载：当前docker-compose.yml仅挂载了命名卷data到/data路径，容器运行时读取的是镜像构建时COPY进去的静态代码，本地修改的文件完全不会同步到容器内，根本没有触发重载的基础条件。
• Gunicorn未开启重载开关：Gunicorn默认关闭文件监听能力，哪怕代码同步到容器、Flask配置了开发环境，不显式传--reload参数的话，Gunicorn不会自动重启工作进程加载新代码。注意你配置的FLASK_ENV=development仅对Flask自带的flask run开发服务器生效，不会影响Gunicorn的行为。

1. 调整docker-compose卷挂载配置 #

将本地项目根目录挂载到容器的工作路径/app，确保本地代码变更能实时同步进容器，业务需要的data持久化卷可以按需保留：

version: '3'
services:
  jfrog-api:
    build: .
    image: jfrog-api
    ports:
      - "${JFROG_API_PORT:-5000}:5000"
    volumes:
      # 挂载本地代码到容器工作目录，加:ro可设置为只读挂载，避免容器内操作意外修改本地文件
      - ./:/app
      # 如需保留/data目录持久化能力，取消下一行注释即可
      # - data:/data
    env_file: .env
    # 开发调试阶段建议设置为no，避免代码报错时容器无限重启
    restart: no
volumes:
  data:

如果是Windows/WSL2、Mac环境挂载后出现文件变更事件不触发的问题，可以后续配合Gunicorn轮询监听配置解决。

2. 为Gunicorn开启热重载能力 #

推荐直接在docker-compose配置中覆盖启动命令，不需要修改Dockerfile，避免把开发环境配置写死到镜像中：

services:
  jfrog-api:
    # 其余配置保持和上一步一致
    # 跨文件系统挂载时加上--reload-engine=poll和--reload-interval=1，用轮询方式监听文件变更，兼容性更好
    command: gunicorn --reload --reload-engine=poll --reload-interval=1 -b 0.0.0.0:5000 jfrog_api:app

如果习惯直接修改Dockerfile的启动命令，也可以把原CMD替换为以下内容，注意生产环境构建镜像前必须移除--reload相关参数：

CMD ["gunicorn", "--reload", "--reload-engine=poll", "--reload-interval=1", "-b", "0.0.0.0:5000", "jfrog_api:app"]

3. 重建容器生效 #

执行以下命令重建并启动容器：

docker-compose up -d --build

后续本地修改代码后，能在容器日志中看到Worker reloading的提示，即代表热重载正常工作。

重要提醒：Gunicorn的--reload参数仅适合本地开发调试使用，生产环境必须关闭，否则会带来额外性能损耗与安全风险。

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