Docker Compose下Angular与Nginx容器文件共享报错求助

DevOps 小满

2026-5-29

我刚碰到过几乎一模一样的坑！让我给你拆解下问题根源和可行的解决办法：

问题原因

Angular CLI的ng build --prod命令默认会先删除现有的dist目录，再重新编译生成新的产物。但你把/app/client/dist直接挂载到了Docker卷上，这时候这个目录被Docker的卷挂载机制占用着，Angular CLI根本没法删除它，所以就抛出了EBUSY: resource busy or locked的错误。另外你Nginx配置里的卷路径也写错了，应该是/usr/share/nginx/html（你写的share/user/nginx/html缺了开头的根路径符号）。

解决办法

方法1：调整卷挂载位置，避免直接占用构建目录

不要把卷直接挂载到Angular要操作的dist目录，而是挂载到一个独立的目录，让构建完成后再把产物复制过去。修改你的docker-compose.yml：

services:
  client:
    build: ./client # 假设你的client有对应的Dockerfile
    # 先执行构建，再把dist产物复制到卷挂载的目录
    command: sh -c "ng build --prod && cp -r /app/client/dist/* /app/client/static/"
    volumes:
      - static:/app/client/static
  nginx:
    image: nginx:alpine
    volumes:
      - static:/usr/share/nginx/html # 修正Nginx的路径
    ports:
      - "80:80"
volumes:
  static:

这样Angular构建时操作的是本地的dist目录（没有被挂载），构建完再把产物同步到卷里，就不会有资源占用冲突了。

方法2：禁止Angular CLI删除构建目录

修改你的angular.json配置，让构建命令跳过删除dist目录的步骤，只覆盖文件：
找到projects -> [你的项目名] -> architect -> build -> options，添加：

"deleteOutputPath": false

这个方法最简单，但缺点是dist目录里会残留旧的文件（比如删除的组件、资源），适合开发调试场景，生产环境不推荐。

方法3：用多阶段构建直接打包到Nginx镜像（最推荐生产环境）

完全抛弃共享卷，用Docker多阶段构建把Angular产物直接打包进Nginx镜像，部署更干净：
创建client的Dockerfile：

# 第一阶段：构建Angular产物
FROM node:18-alpine as builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
RUN npm run build --prod

# 第二阶段：把产物复制到Nginx镜像
FROM nginx:alpine
# 可以替换成你自己的Nginx配置文件
COPY ./nginx.conf /etc/nginx/conf.d/default.conf
COPY --from=builder /app/dist /usr/share/nginx/html

然后修改docker-compose.yml：

services:
  nginx:
    build: ./nginx # 如果有自定义Nginx配置的话，不然直接用官方镜像
    ports:
      - "80:80"

这种方式镜像包含了所有静态资源，部署时不需要依赖外部卷，更符合Docker的最佳实践。

最后小提醒

不管用哪种方法，记得先执行docker-compose down -v删除旧的卷和容器，避免残留的旧数据影响新配置。

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