Windows环境Docker容器部署Flask项目热重载失效问题求助

问题场景 #

在Windows系统上使用Docker容器开发项目时，修改本地代码后必须重启容器才能生效，已尝试修改启动命令、添加DEBUG环境变量均无效，且不想引入第三方工具实现热重载。
现有配置如下：

docker-compose.yml #

version: "3"

services:
  # FLASK
  flask-dev:
    container_name: flask-dev
    hostname: flask-dev
    restart: "on-failure"
    build:
      context: ./server
    volumes:
      - ./server/:/usr/src/app/
    ports:
      - 5000:5000
      - 5678:5678
    env_file:
      - ./env/dev/flask.env
    networks: 
      - appnetwork
      - dbnetwork
      - elknetwork

nginx.conf #

upstream flask {
    server flask-prod:8000;
}

server {
    listen 80;

    location /static {
        alias /usr/src/app/static;
    }

    location / {
        proxy_pass http://flask;
        proxy_redirect off;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_connect_timeout 300;
        proxy_read_timeout 300;
    }
}

Dockerfile #

FROM python:3.7-slim

ENV APP_HOME /usr/src/app
WORKDIR ${APP_HOME}

# Initial setup
RUN apt-get update && apt-get install -y netcat
COPY ./requirements.txt .
RUN pip install -r requirements.txt
RUN mkdir -p /home/vagrant/app-data/

# Copy all files
COPY . .

# Run entrypoint checks
ENTRYPOINT ["/usr/src/app/entrypoint.sh"]

entrypoint.sh #

#!/bin/sh

echo "Running Prettier checks"
npx prettier --check .
# npx prettier --list-different --write .

echo "Starting app"
npm start

无需第三方工具的解决步骤 #

• 1. 修正Docker Desktop文件共享配置
     打开Docker Desktop设置，进入「资源→文件共享」，勾选项目所在的磁盘分区；如果使用WSL2后端，进入「通用」设置确认已开启WSL2引擎，同时在「资源→WSL集成」中开启项目所在WSL发行版的集成权限，确保Windows本地的文件变更事件可以正常传递到容器内。
• 2. 调整开发服务启动配置
     如果你是纯Flask后端项目，当前entrypoint.sh中的npm start不符合技术栈要求，替换为Flask原生的调试启动命令，开启自带的热重载能力：

  #!/bin/sh
  echo "Running Prettier checks"
  npx prettier --check .
  
  echo "Starting Flask dev server"
  export FLASK_APP=app.py # 替换为你实际的Flask入口文件名
  export FLASK_ENV=development
  flask run --host=0.0.0.0 --reload --debugger
  

  如果你是前后端同构项目，需要用npm启动前端开发服务，只需要在打包工具的配置中开启轮询检测即可，不需要额外工具：
  • 若使用Webpack：在devServer配置中添加watchOptions: { poll: 1000 }
  • 若使用Vite：在vite.config.js中添加server: { watch: { usePolling: true } }
• 3. 补充docker-compose环境变量
     在docker-compose.yml的flask-dev配置块中添加如下环境变量，确保调试和重载能力正常开启：

  environment:
    - FLASK_ENV=development
    - FLASK_DEBUG=1
    - WATCHPACK_POLLING=true # 前端项目可添加此参数，强制开启轮询检测文件变更
  

• 4. 修正Nginx代理配置（开发环境）
     你当前Nginx配置中默认代理到flask-prod:8000，如果开发环境也通过Nginx访问，需要把上游地址改为开发容器的地址：

  upstream flask {
      server flask-dev:5000; # 替换为开发容器的服务名和端口
  }
  

• 5. 重启容器验证效果
     执行docker-compose up --build flask-dev重新构建启动容器，之后修改本地的HTML、Python等代码文件，服务会自动重载，不需要手动重启容器。

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