Docker部署NestJS应用遇EACCES权限错误：无法创建dist目录

1. 修正Dockerfile的权限配置顺序与路径匹配 #

你之前的chown命令失效，大概率是路径不匹配或者用户切换时机不对。比如你用/usr/src/app作为工作目录，但给/app改权限，自然没用。调整Dockerfile如下：

FROM node:18-alpine

# 明确工作目录
WORKDIR /usr/src/app

# root用户下先装依赖（避免权限问题）
COPY package*.json ./
RUN npm install

# 复制项目代码
COPY . .

# 给当前工作目录全量赋予node用户权限，必须在切换用户前执行
RUN chown -R node:node /usr/src/app

# 切换到非root的node用户
USER node

# 开发环境启动命令
CMD ["npm", "run", "start:dev"]

2. 处理docker-compose卷挂载的权限冲突 #

如果你的docker-compose里挂载了本地目录到容器内，本地目录的权限会覆盖容器内设置，导致node用户无法创建dist目录。两种解决办法：

• 直接在compose中指定运行用户：

services:
  app:
    build: .
    user: "node"
    volumes:
      - .:/usr/src/app
      - /usr/src/app/node_modules

• 本地提前创建dist目录并适配权限：

mkdir dist
sudo chown 1000:1000 dist  # node镜像默认node用户的UID/GID是1000

3. 调整npm编译脚本 #

在package.json的启动脚本中，先强制创建dist目录再编译，绕过权限限制：

{
  "scripts": {
    "start:dev": "mkdir -p dist && nest start --watch"
  }
}

4. 核对Node镜像的用户UID/GID #

部分Node镜像的node用户UID不是默认的1000，先进入容器确认：

docker exec -it <你的容器ID> id node

如果返回UID是其他值（比如1001），修改Dockerfile中的chown命令：

RUN chown -R 1001:1001 /usr/src/app

5. 临时用root用户验证（排查用） #

如果以上方法都没效果，先注释掉Dockerfile里的USER node，用root用户启动容器。如果不再报错，说明确实是用户权限配置的问题，回到前面的步骤逐一排查。

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