Docker部署NextJS开发环境遇权限错误：找不到.next文件夹

云原生阿岚

2026-8-10

解决Docker运行Next.js开发环境EACCES权限错误

问题现象

启动容器后出现权限拒绝错误：

nti-web-web-1 | ready - started server on 0.0.0.0:3000, url: http://localhost:3000
nti-web-web-1 | [Error: EACCES: permission denied, open '/app/.next/package.json'] {
nti-web-web-1 | errno: -13,
nti-web-web-1 | code: 'EACCES',
nti-web-web-1 | syscall: 'open',
nti-web-web-1 | path: '/app/.next/package.json'
nti-web-web-1 | }
nti-web-web-1 exited with code 1

核心原因

本地目录挂载到容器后，容器内默认的node用户与本地文件的权限不匹配，导致Next.js无法创建或读写.next目录下的文件；或是本地已存在的.next目录权限不符合容器内用户的访问要求。

解决方案

方案1：清理本地`.next`目录

本地挂载的卷会覆盖容器内目录，若本地之前生成过.next，其权限可能与容器内node用户不兼容。执行命令删除本地.next：

rm -rf .next

重新启动容器，让Next.js在容器内重新生成.next目录。

方案2：调整Dockerfile，使用`node`用户并设置目录权限

修改Dockerfile，确保容器内/app目录归node用户所有，并切换到node用户运行服务：

FROM node:18-alpine
WORKDIR /app
# 设置目录权限为node用户
RUN chown -R node:node /app
# 切换到node用户
USER node
COPY ./package.json .
RUN npm install
COPY . .
EXPOSE 3000
CMD ["npm","run","dev"]

重新构建镜像并启动容器：

docker-compose down
docker-compose build --no-cache
docker-compose up

方案3：在docker-compose中指定运行用户

在docker-compose.yml的web服务中添加user字段，指定用node用户运行：

version: "3"
services:
  web:
    build:
      context: .
      dockerfile: Dockerfile.dev
    volumes:
      - ./:/app
      - /app/node_modules
    ports:
      - 3000:3000
    working_dir: /app
    # 指定运行用户
    user: "node"

调整配置后直接重启容器即可。