Docker卷映射当前目录至/app路径失效问题咨询

问题现象 #

Docker版本20.10.21，执行以下命令时容器能正常运行，端口显示正常：

docker run -d -v ${pwd}:/app2 react-app

但将挂载目标改为/app时，容器启动异常，端口无法显示：

docker run -d -v ${pwd}:/app react-app

问题原因 #

Docker的-v绑定挂载机制会完全覆盖容器内目标路径的原有内容。结合你提供的Dockerfile来看：

FROM node:14.16.0-alpine3.13
RUN addgroup app && adduser -S -G app app
USER app
WORKDIR /app
RUN mkdir data
COPY package*.json .
RUN npm install
COPY . .
ENV API_URL=http://api.myapp.com/
EXPOSE 3000
CMD [ "npm", "start" ]

容器的WORKDIR被设置为/app，后续的npm install会在该目录生成node_modules依赖文件夹，COPY命令也会把项目代码复制到这里。当你把本地目录挂载到/app时，容器内原本的/app目录（包含node_modules、项目代码等关键文件）会被本地目录完全替换。而本地目录通常不会包含node_modules（一般会通过.gitignore排除），导致npm start找不到依赖，容器启动失败，自然不会显示端口。

解决方案 #

1. 挂载到/app下的子目录（推荐） #

不要直接覆盖整个/app，而是挂载到/app下的具体业务子目录，比如项目的src目录：

docker run -d -v ${pwd}/src:/app/src react-app

这样既可以同步本地开发代码，又不会破坏容器内的node_modules等关键依赖文件，保证容器能正常启动。

2. 单独挂载数据目录（针对数据持久化需求） #

如果是为了持久化容器内的data目录，没必要挂载整个/app，单独挂载/app/data即可：

docker run -d -v ${pwd}/data:/app/data react-app

3. 调整挂载逻辑（不推荐，仅作备选） #

如果一定要挂载本地目录到/app，先在本地项目根目录创建.dockerignore文件，排除不需要同步到容器的文件：

node_modules
.git
.DS_Store

然后在本地执行npm install生成完整依赖，再执行挂载命令。不过这种方式存在本地环境与容器环境依赖不兼容的风险，不推荐使用。

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