Docker构建NX+Next.js+NestJS单体仓库时遇目录创建失败错误

• 核心问题：权限不匹配
  容器内运行nx serve的用户，没有权限创建或写入/app/node_modules/.cache/nx目录，大概率是本地目录挂载到容器后权限冲突，或是容器默认用户（root）与本地文件权限不兼容导致。

• 具体解决方法

  1. Dockerfile中配置非root用户并授权
     避免用root运行容器，创建专属用户并赋予/app目录读写权限：

     # 基础镜像步骤后添加
     RUN addgroup --system appgroup && adduser --system appuser --ingroup appgroup
     RUN chown -R appuser:appgroup /app
     USER appuser
     

  2. 运行容器时匹配本地用户UID/GID
     启动容器时指定与本地用户一致的权限，避免挂载卷的权限冲突：

     docker run --user $(id -u):$(id -g) [你的镜像名]
     

  3. 提前创建缓存目录并设置权限
     在Dockerfile中预创建缓存目录并开放权限（若未挂载本地node_modules时生效）：

     RUN mkdir -p /app/node_modules/.cache/nx && chmod -R 775 /app/node_modules/.cache/nx
     

     若挂载了本地node_modules，先在本地执行：

     mkdir -p node_modules/.cache/nx && chmod -R 775 node_modules/.cache/nx
     

  4. 修改NX缓存路径到临时目录
     在nx.json中指定缓存到容器内默认开放权限的/tmp目录：

     {
       "cacheDirectory": "/tmp/nx-cache"
     }
     

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