如何解决CodeArtifact登录后无法使用已上传npm包的问题？

以下是几种常见的原因及对应的解决方法：

1. .npmrc未配置默认下载源（无包范围场景） #

当仓库和包都未设置范围时，aws codeartifact login默认生成的配置可能仅针对特定范围（即便你没设置），导致npm尝试从公共npm源拉取你的私有包。

• 解决步骤：
  1. 打开生成的.npmrc文件，删除带@scope:registry的行
  2. 添加默认registry配置：

     registry=https://<domainName>-<Domain owner ID>.d.codeartifact.<region>.amazonaws.com/npm/repoName/
     always-auth=true
     

  3. 重新执行aws codeartifact login --tool npm --repository repoName --domain domainName --domain-owner <Domain owner ID> --region <your-region>，确保带上正确的区域参数

2. Node.js 18与npm的兼容性或缓存问题 #

Node.js 18搭配部分早期npm 8.x版本可能存在认证缓存或registry解析的异常。

• 解决步骤：
  1. 清理npm本地缓存：npm cache clean --force
  2. 确认npm版本为8.19+（Node18推荐配套版本），若版本过低则升级：npm install -g npm@latest
  3. 重新登录CodeArtifact并尝试安装包

3. 包未正确发布到CodeArtifact #

可能存在发布不完整、package.json配置错误，或发布时未指定CodeArtifact源的情况。

• 解决步骤：
  1. 登录AWS控制台，进入CodeArtifact仓库确认目标包及版本是否存在
  2. 本地项目中检查package.json的main字段是否指向正确的编译后文件，files字段是否包含所有需要发布的文件（如编译后的JS、类型声明）
  3. 重新发布包，明确指定CodeArtifact源：

     npm publish --registry=https://<domainName>-<Domain owner ID>.d.codeartifact.<region>.amazonaws.com/npm/repoName/
     

4. AWS IAM权限不足 #

执行登录的AWS用户/角色缺少读取CodeArtifact仓库的权限，导致无法拉取包。

• 解决步骤：
  1. 为当前IAM用户/角色附加包含以下权限的策略：

     {
         "Version": "2012-10-17",
         "Statement": [
             {
                 "Effect": "Allow",
                 "Action": [
                     "codeartifact:ReadFromRepository",
                     "codeartifact:GetPackageVersion",
                     "codeartifact:ListPackageVersions"
                 ],
                 "Resource": "arn:aws:codeartifact:<region>:<Domain owner ID>:domain/<domainName>/repository/<repoName>"
             }
         ]
     }
     

  2. 重新获取AWS凭证（如刷新角色会话）后再次尝试安装

5. 网络或区域配置错误 #

当前环境无法访问CodeArtifact的区域端点，或登录时未指定正确的区域。

• 解决步骤：
  1. 确认仓库所在区域，在登录命令中明确添加--region <your-region>参数
  2. 测试网络连通性：使用curl访问仓库地址，确认能正常返回响应

     curl https://<domainName>-<Domain owner ID>.d.codeartifact.<region>.amazonaws.com/npm/repoName/
     

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