Ubuntu服务器npm install报错TAR_BAD_ARCHIVE问题求助

问题描述 #

本地Windows/macOS环境执行npm install可正常完成，但在Ubuntu 22.04服务器端安装失败，核心报错：

npm ERR! TAR_BAD_ARCHIVE: Unrecognized archive format
此错误发生在包安装过程中，日志显示提取部分包时出现问题。

环境信息 #

本地环境 #

• OS: Windows 11
• Node.js版本: 18.20.5
• npm版本: 10.2.3

服务器环境 #

• OS: Ubuntu 22.04 LTS
• Node.js版本: 18.20

完整错误日志 #

npm ERR! 本次运行的完整日志可查看：/root/.npm/_logs/2024-12-17T11_59_28_172Z-debug-0.log
root@zotac31870:~/zota-cpos-backend-ts# npm i
npm WARN tar TAR_BAD_ARCHIVE: Unrecognized archive format
npm WARN deprecated inflight@1.0.6: 该模块不再受支持，存在内存泄漏问题，请勿使用。如需通过键值合并异步请求的可靠方案，可选用lru-cache，其功能更全面强大。
npm WARN deprecated npmlog@5.0.1: 该包已不再受支持。
npm WARN deprecated rimraf@2.7.1: Rimraf v4之前的版本已不再受支持
npm WARN deprecated har-validator@5.1.5: 该库已不再受支持。
npm WARN deprecated rimraf@3.0.2: Rimraf v4之前的版本已不再受支持
npm WARN deprecated are-we-there-yet@2.0.0: 该包已不再受支持。
npm WARN deprecated glob@7.2.3: Glob v9之前的版本已不再受支持
npm WARN deprecated querystring@0.2.0: querystring API被视为遗留API，新代码应使用URLSearchParams API替代。
npm WARN deprecated gauge@3.0.2: 该包已不再受支持。
npm WARN deprecated uuid@3.4.0: 请升级至v7或更高版本。旧版本在某些情况下可能使用Math.random()，存在已知问题。
npm WARN deprecated fstream@1.0.12: 该包已不再受支持。
npm WARN deprecated request@2.88.2: request已被弃用。

修复步骤 #

1. 清理npm缓存
   缓存损坏是归档格式错误的常见诱因，强制清理后重新拉取包：

   npm cache clean --force
   

2. 移除本地依赖文件
   本地生成的锁文件可能和服务器环境不兼容，删除后让npm重新生成适配服务器的依赖树：

   rm -rf node_modules package-lock.json
   

3. 统一npm版本
   服务器npm版本未明确，建议升级到和本地一致的10.2.3版本，版本差异可能导致包处理逻辑不一致：

   npm install -g npm@10.2.3
   

4. 优化网络下载
   服务器网络不稳定可能导致包下载不完整，可切换国内镜像加速：

   npm config set registry https://registry.npmmirror.com/
   

   之后重新执行npm install。

5. 对齐Node.js小版本
   服务器Node.js版本为18.20，本地是18.20.5，小版本差异也可能引发依赖处理异常，建议升级到同版本：

   nvm install 18.20.5
   nvm use 18.20.5
   

内容的提问来源于stack exchange，提问作者Subhash S Kandakur