使用环境变量在docker-compose挂载目录失败问题排查

核心原因 #

你遇到的错误是因为容器卷挂载是在容器启动时完成的，而Dockerfile中的RUN命令是在镜像构建阶段执行的。也就是说，当构建镜像运行RUN ls -al /app/my_app时，docker-compose.yml中配置的本地目录还没有挂载到容器里，自然找不到这个路径。

解决步骤 #

1. 先在Dockerfile中创建目标目录

在执行涉及/app/my_app的命令前，先手动创建这个目录（即使之后会被卷覆盖，构建阶段也需要它存在）：

# 添加这行来创建目录
RUN mkdir -p /app/my_app

# 如果你只是用来排查，可以保留这行，但要明白此时目录是空的（还没挂载）
RUN ls -al /app/my_app && sleep 10

或者直接删掉那个排查用的RUN命令，因为它在构建阶段根本看不到挂载的内容。

2. 验证卷挂载是否成功（容器启动后）

镜像构建完成、容器启动后，卷才会挂载。可以通过以下命令验证：

# 进入运行中的容器
docker exec -it <你的容器名或ID> bash

# 查看挂载目录内容
ls -al /app/my_app

3. 确认权限与路径正确性

• 确保宿主机的/Users/myuser/myrepos/my_app目录确实存在。
• 在Mac上，检查Docker Desktop的设置，确认已经允许访问该目录所在的磁盘（否则Docker会没有权限挂载）。

关键提示 #

• Dockerfile的RUN命令只能操作镜像内部的文件，无法访问宿主机的卷内容——卷是容器运行时才会挂载的动态共享机制。
• 如果你的构建步骤需要依赖/app/my_app里的文件，应该用COPY或ADD命令从构建上下文把文件复制到镜像中，而不是依赖卷挂载。卷适合在容器运行时动态更新文件，而非构建阶段。

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