npm安装报EACCES:先核对目录与账号
在 Linux 服务器执行 npm 安装时出现 EACCES: permission denied,先看错误里的 path 和 syscall。项目目录、用户缓存和全局安装目录的处理方法不同,不能统一在命令前加 sudo。
本篇适用于普通部署账号下的 npm 项目。使用项目已验证的 Node.js、npm 版本;权限报错不等于需要升级版本,也不要套用到仓库返回的401、403认证错误。
先确认谁在安装、准备写到哪里
进入项目根目录后执行以下检查。这些命令只显示账号、位置和指定配置,不会安装依赖:
id
pwd
node -v
npm -v
npm prefix
npm config get cache
npm config get prefix
若当前是 root,先切换到项目指定的普通部署账号。部署账号和运行服务的账号可以不同;不要为了方便安装,直接让线上服务以 root 运行。
| 错误路径落点 | 优先检查 |
|---|---|
| 项目内的node_modules、package-lock.json等 | 当前账号是否有项目及目标父目录的写入权限 |
| cache配置指向的目录内部 | 缓存是否属于另一个账号,是否曾用sudo生成文件 |
| 全局prefix内,例如/usr/local/lib/node_modules | 是否执行了-g全局安装,是否确实需要全局工具 |
项目目录报错:先检查属主,不改整个系统
ls -ld -- . node_modules package.json package-lock.json
尚未生成的文件可能提示不存在,以实际报错目标及其父目录为准。若依赖由另一个账号创建,优先从同一发布包重新准备一个部署账号可写的新构建目录,再按锁文件安装。
线上运行目录可能本来就设计为只读,不应为了安装依赖强行放开。确需纠正属主时,由管理员先核对真实路径、符号链接和目录用途,再限定到该项目。不要执行整盘、整个家目录或整个系统安装目录的递归改权,也不要使用777权限。
缓存报错:使用当前账号控制的缓存
先核对 npm config get cache 的输出。若它指向其他账号的目录,应先纠正账号或配置。不要用 sudo 清空缓存来掩盖问题,清缓存并不能修复目录属主。
确认是旧缓存权限问题后,可在新的构建目录中使用当前账号家目录下的独立缓存。下方目录名是示例;若已存在,先确认它由当前账号控制:
npm ci --cache="$HOME/.npm-cache-user"
此命令要求项目有匹配的锁文件,并会移除当前项目已有的 node_modules。因此只在准备好的构建目录运行,不要直接用于正在提供服务的站点目录。其他安装参数继续沿用项目约定。
全局安装报错:优先使用项目本地工具
项目已声明的构建、测试工具,通常应随本地依赖安装,再通过项目的 npm run 脚本调用。没有必要为了一个项目把所有工具装到系统全局目录。
确需用户级全局工具、且没有使用版本管理器时,先备份用户的 .npmrc,再将全局前缀设到自己的目录:
npm config set prefix="$HOME/.local" --location=user
export PATH="$HOME/.local/bin:$PATH"
第二行仅更新当前 shell;需要长期使用时,按所用 shell 把该目录加入启动配置后重新登录。已使用版本管理器的环境沿用原方案,不叠加前缀修改,也不更换现有服务的 Node.js 路径。
修复后检查什么
用同一普通账号重跑原安装流程,确认错误路径不再出现 EACCES,再执行项目规定的构建、测试和发布验收。若属主看起来正常仍失败,应继续检查父目录权限、ACL及运行环境限制,而不是继续扩大权限。
提交工单时附上账号、Node.js/npm版本、原命令和错误中的 code、syscall、path。日志中的令牌先脱敏;不要发送 .npmrc全文、.env内容或SSH私钥。
项目依赖安装完成后,需要配置后台运行、反向代理和重启恢复,可继续看Node.js项目上线教程。