Docker挂载本地目录并保留node_modules时遇EACCES权限错误求助

问题原因 #

你遇到的EACCES: permission denied, mkdir '/app/node_modules/.cache'错误，核心原因是：

• node:alpine镜像默认以root用户运行，镜像中/app/node_modules目录及文件的所有者为root
• 挂载本地目录到/app后，容器内运行npm run start的进程（默认root）在创建ESLint缓存目录时，因本地目录权限与容器内root用户的权限冲突，或Dev Server/ESLint的运行机制限制，导致无法写入node_modules目录

解决方案 #

方案1：Dockerfile中使用非root用户运行（推荐） #

修改Dockerfile，创建并切换到非root用户执行操作，确保依赖目录与运行进程的权限一致：

FROM node:alpine

# 创建非root用户组和用户
RUN addgroup -S appgroup && adduser -S appuser -G appgroup

WORKDIR /app

# 先复制package文件，利用镜像缓存优化构建
COPY package*.json ./
RUN npm install

# 复制项目代码
COPY . .

# 切换到非root用户
USER appuser

# 启动应用
CMD ["npm", "run", "start"]

重新构建镜像后，使用原命令启动容器：

sudo docker run -p 3000:3000 -v /app/node_modules -v "$(pwd)":/app <新镜像ID>

方案2：临时调整容器内node_modules权限（测试用） #

若不想修改Dockerfile，可在启动容器时先修改node_modules的权限：

sudo docker run -p 3000:3000 -v /app/node_modules -v "$(pwd)":/app <镜像ID> sh -c "chmod -R 777 /app/node_modules && npm run start"

⚠️ 注意：777权限过于宽松，仅适合本地测试，生产环境禁止使用。

方案3：指定容器运行用户为宿主用户UID #

查看宿主用户UID（执行id -u命令），在启动容器时指定该UID，让进程以与宿主目录匹配的身份运行：

# 替换1000为你的实际UID
sudo docker run -p 3000:3000 -v /app/node_modules -v "$(pwd)":/app -u 1000 <镜像ID>

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