在node v18.12.1/npm 8.19.2中如何在install前触发AWS CodeArtifact登录？

问题描述 #

根据npm文档，preinstall脚本应当在install脚本之前自动运行。在Node.js v14.21.1/npm 6.14.17环境下，我通过preinstall脚本触发AWS CodeArtifact登录，执行npm install时能正常从CodeArtifact仓库拉取依赖包。

升级到Node.js v18.12.1/npm 8.19.2后，执行npm install时报错：

Unable to authenticate, your authentication token seems to be invalid

在无npm缓存的全新环境中完成以下测试：

• 手动执行npm run preinstall可成功完成AWS CodeArtifact登录，说明AWS凭证配置正常且脚本本身无问题；
• 直接执行npm install时认证失败；
• 手动先执行npm run preinstall; npm install可成功登录并完成依赖安装，同时调试日志中找不到co:login（preinstall脚本中的核心步骤）的执行记录，证明preinstall脚本未被自动触发。

回退到Node.js v14.21.1/npm 6.14.17环境后，npm install恢复正常。我已通过最小化的package.json在Docker容器中复现该问题，包含完整的容器操作步骤、package.json和package-lock.json模板（需替换为自有CodeArtifact信息）。

可能的原因与解决方案 #

1. npm 8.x生命周期脚本执行逻辑变更 #

npm 8.x对生命周期脚本的执行规则做了优化调整：当执行npm install且未指定具体包、同时package-lock.json已存在时，npm会跳过部分生命周期脚本以提升安装速度，preinstall可能在此列。

解决方法：

• 执行npm install --ignore-scripts=false强制触发所有生命周期脚本；
• 若可接受重新生成锁文件，可删除package-lock.json后再执行npm install。

2. npm 8.x install命令默认行为调整 #

在npm 8.x中，当已有package-lock.json时，npm install会优先基于锁文件完成依赖安装，此场景下可能不会触发preinstall脚本。

解决方法：

• 将preinstall脚本替换为prepare脚本，prepare脚本在npm install（无论是否存在锁文件）、npm pack、npm publish时都会触发，兼容性更强。修改package.json脚本配置示例：

  {
    "scripts": {
      "prepare": "aws codeartifact login --tool npm --repository <你的仓库名> --domain <你的域名> --domain-owner <你的所有者ID>"
    }
  }
  

3. 环境变量或权限上下文问题 #

npm 8.x对环境变量传递、脚本执行权限的要求更严格，可能导致preinstall脚本在npm install的执行上下文中无法获取到AWS凭证。

解决方法：

• 确保执行npm install时，AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY等相关环境变量已正确传递至npm的执行上下文；
• 在Docker容器中执行时，可通过docker run --env AWS_ACCESS_KEY_ID=xxx --env AWS_SECRET_ACCESS_KEY=xxx ...显式传递环境变量，或在容器启动脚本中先导出这些变量再执行npm install。

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