AWS CodeArtifact PyPi仓库无法安装通过Twine上传的包

我之前帮同事排查过好几次类似的问题，咱们一步步来揪出可能的原因：

• 先核对包名的大小写与拼写细节
  PyPi生态（包括CodeArtifact）对包名是大小写不敏感但存储时保留大小写的，有时候会出现“安装时小写找不到，但用上传时的原大小写就能找到”的情况。你可以直接访问索引的具体包路径试试：把你看到的索引URL后面加上/blahblah-utilities/（或者你上传时的准确包名），看看能不能看到对应的.whl文件。如果访问原大小写的路径能看到，那安装时就用那个准确的包名试试。

• 检查包版本与本地Python环境的兼容性
  如果你上传的.whl是针对特定Python版本构建的（比如文件名里有py311），但你本地用的是Python 3.9，pip会自动过滤掉不兼容的版本，就会显示“无匹配版本”。你可以加--verbose参数看详细日志：pip install blahblah-utilities --verbose，日志里会明确告诉你哪些版本被过滤以及原因；也可以直接看你上传的.whl文件名，确认本地Python版本符合要求。

• 清除pip缓存试试
  pip经常会缓存旧的索引数据，哪怕你刚上传了包，它可能还是用的旧缓存。最简单的办法是清空缓存：pip cache purge，然后再重新安装；或者直接加--no-cache-dir参数强制不使用缓存：pip install blahblah-utilities --no-cache-dir。

• 确认Twine上传的仓库完全正确
  会不会上传的时候不小心指定了错误的仓库URL？比如把our-main-repo写成了其他仓库名？你可以登录AWS控制台，进入CodeArtifact的our-main-repo仓库，查看“包”列表，确认blahblah-utilities确实在里面。

• 检查仓库的权限与上游配置
  虽然你能上传包，但还是要确认下当前用于安装的IAM身份（用户/角色）有没有codeartifact:ReadFromRepository权限。另外，如果你的仓库关联了上游PyPi仓库，有时候pip可能会优先去上游查找，但你的包只在私有仓库里——不过这种情况一般不会直接显示“无匹配版本”，但也可以去仓库的“上游”配置里确认下有没有干扰。

备注：内容来源于stack exchange，提问作者sheikhness