Flask容器切换非root用户后绑定挂载目录代码变更不自动重载

问题根因 #

1. 绑定挂载的相对路径解析错误
   docker-compose 配置中，卷挂载的相对路径是相对于执行 docker-compose 命令的工作目录，而非 docker-compose.yml 文件所在的目录。你是在项目根目录执行启动命令，配置里写的..:/home/appuser会指向项目根目录的上层目录，而非你预期的项目根目录，导致挂载路径完全错误，自然检测不到本地代码变更。而你执行docker run时用的是$(PWD)变量，直接指向当前工作目录（项目根目录），所以挂载正常。

2. 用户权限不匹配（次要排查点）
   容器内使用普通用户appuser运行时，如果appuser的UID/GID和宿主机上项目文件的所有者UID/GID不一致，会导致容器内用户没有权限读取挂载目录的文件，也会无法检测文件变更。

修复方案 #

1. 修正卷挂载路径
   把docker/docker-compose.dev.yml中的卷配置修改为以下任意一种即可：

# 方案1：用当前工作目录变量，和docker run逻辑一致，兼容性最好
volumes:
  - ${PWD}:/home/appuser

# 方案2：如果你固定在项目根目录执行compose命令，直接写相对路径
volumes:
  - .:/home/appuser

2. 权限适配（如果路径修正后仍不生效）
   在Dockerfile中创建用户时指定和宿主机一致的UID/GID，比如宿主机普通用户UID通常为1000，修改docker/Dockerfile.dev的用户创建逻辑：

# 替换原有useradd命令，指定UID为1000
RUN useradd --create-home -u 1000 appuser

如果需要适配不同开发环境的UID，可以在compose配置中添加运行时用户参数：

services:
  api:
    # 其他配置不变
    user: "${UID:-1000}:${GID:-1000}"

验证方法 #

修改配置后重建容器，执行以下命令进入容器，检查挂载目录的内容是否和本地项目目录一致：

docker-compose -p myproject -f docker/docker-compose.dev.yml exec api ls /home/appuser

修改本地代码后再次查看容器内对应文件，确认内容同步后Flask就可以正常检测变更自动重载了。

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