在Amazon Linux 2 Node.js实例添加新npm依赖遇错求助

问题场景 #

• 部署环境：Elastic Beanstalk，64位Amazon Linux 2/5.8.7，Node.js 16（已废弃平台）
• 操作：推送包含新增依赖@tensorflow/tfjs的代码变更
• 错误日志：

  2023/11/01 22:19:38.573395 [INFO] Using npm v8
  2023/11/01 22:19:38.573411 [INFO] Running command /bin/su webapp -c npm --omit=dev install
  2023/11/01 22:20:12.128248 [INFO] npm WARN tar ENOENT: Cannot cd into '/var/app/staging/node_modules/@tensorflow/tfjs'
  npm WARN tar TAR_ENTRY_ERROR ENOENT: no such file or directory, open '/var/app/staging/node_modules/yauzl/package.json'
  npm WARN tar TAR_ENTRY_ERROR ENOENT: no such file or directory, open '/var/app/staging/node_modules/yocto-queue/license'
  

• 已尝试操作：移除.gitignore中的node_modules并提交至Git，但错误依旧。

解决方案 #

方案1：重新生成兼容Linux环境的node_modules #

本地非Linux环境（如macOS/Windows）安装的依赖可能包含系统专属二进制文件，导致EB的Linux环境无法正常读取。按以下步骤操作：

1. 删除本地依赖文件：

   rm -rf node_modules package-lock.json
   

2. 优先在WSL/Linux容器中执行生产依赖安装：

   npm install --production
   

   若没有Linux环境，直接在本地执行上述命令（虽不能完全避免架构问题，但能解决大部分路径/权限问题）
3. 提交生成的文件：

   git add node_modules package-lock.json
   git commit -m "Reinstall production dependencies for Linux compatibility"
   git push
   

方案2：强制EB重新安装所有依赖（推荐） #

不依赖本地提交的node_modules，让EB在部署时自行安装，避免兼容性问题：

1. 在项目根目录创建.ebextensions/01_npm_install.config文件，写入：

   container_commands:
     01_clean_node_modules:
       command: "rm -rf node_modules"
     02_install_deps:
       command: "npm install --omit=dev"
       leader_only: true
   

2. 将该文件提交到Git后重新部署，EB会先清除原有node_modules，再重新安装生产依赖。

方案3：清除EB部署缓存 #

EB可能缓存了损坏的依赖文件，导致解压失败：

• 控制台操作：进入EB环境→「配置」→「软件」→点击「更新软件」，选择「清除缓存并重新部署」
• CLI操作：

  eb deploy --staged --clear-cache
  

方案4：升级平台（长期解决方案） #

Node.js 16已废弃，对应的EB平台也不再维护，升级到Node.js 18/20对应的Amazon Linux 2平台（如6.x版本），新平台的npm工具和环境配置能修复这类解压兼容性问题。

额外注意事项 #

• 若采用方案2，确保package-lock.json（或yarn.lock）已提交到Git，保证EB安装的依赖版本与本地一致。
• 尝试调整@tensorflow/tfjs的版本，部分旧版本可能存在Node.js 16/Linux下的安装bug，可切换到最新稳定版或已知兼容版本。

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