无法从CodeArtifacts安装npm包：公共依赖被定向私有仓库报错

为什么npm会从私有仓库拉取公共依赖？ #

因为你当前的npm配置把全局registry指向了CodeArtifacts私有仓库，或者安装私有包时未指定仅该包走私有仓。当npm安装任何包（包括公共依赖）时，都会默认向配置的registry发起请求，而你的私有仓库里没有这些公共包，也未配置上游去公共npm仓拉取，所以触发404错误。

解决步骤 #

1. 给CodeArtifacts私有仓库配置上游公共npm源 #

CodeArtifacts支持配置外部上游仓库，当私有仓找不到对应包时，会自动去上游公共仓拉取（还可缓存到私有仓，提升后续请求速度）：

• 使用AWS CLI配置：

  aws codeartifact associate-external-connection --domain <你的Domain名称> --domain-owner <你的AWS账户ID> --repository <私有仓库名称> --external-connection public:npmjs
  

• 或通过AWS控制台操作：
  进入CodeArtifacts页面，找到你的私有仓库，在「外部连接」选项中添加public:npmjs连接。

2. 优化npm registry配置（避免全局指向私有仓） #

如果不需要所有包都走私有仓，建议仅将你的私有包的scope（或特定包）指向CodeArtifacts，其他公共包使用默认npm源：

• 在项目根目录创建/修改.npmrc文件（替换@your-scope为私有包实际scope）：

  @your-scope:registry=https://repo-address.amazonaws.com/npm/repo/
  registry=https://registry.npmjs.org/
  

• 或通过命令行单独配置scope的registry：

  npm config set @your-scope:registry https://repo-address.amazonaws.com/npm/repo/
  

3. 清理缓存重试 #

若配置后仍有问题，清理npm缓存再重新安装：

npm cache clean --force
npm install

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