现象
npm install 突然报 EINTEGRITY: sha512 校验失败,删掉 node_modules 和 loCk 文件重装还是同一段哈希报错,换网络、换 Node 版本都没用,换一台机器就完全正常。
原因
npm 的本地缓存里存着包的压缩包和索引,下载中断、磁盘写满或旧版本 npm 的并发写入都可能让缓存内容与索引不一致。安装时按索引去校验缓存文件,哈希对不上就抛 EINTEGRITY,而且默认不会自动修复。
解决步骤
第一步,先校验再清缓存,别整个目录乱删。verify 能看出损坏条目,clean 之后要重新下载。
npm cache verify
npm cache clean --force
rm -rf node_modules package-lock.json
npm install
第二步,重新生成锁文件并安装。清完缓存后让 npm 重新解析依赖,装完检查 package-lock.json 是否被改写;团队协作时锁文件要一起提交,避免各人装出不同的依赖树。
第三步,排除磁盘和权限因素。缓存目录所在分区写满时同样会产生半截文件,用 df -h 看一眼剩余空间;持续集成环境可把 cache 目录单独挂载,并定期执行 npm cache verify 做主动校验。
验证
npm install 不再出现 EINTEGRITY,npm cache verify 显示校验通过、没有损坏条目,项目构建和启动正常,说明缓存已恢复一致。
小结
EINTEGRITY 是缓存与索引对不上,不是包本身有问题。先 verify 再 clean,配合重建锁文件,通常一轮就能恢复。
