pip3从Artifactory安装wheel包报OSError[Errno2]问题排查咨询

问题原因 #

该问题和你给出的部署代码没有直接关联。pip抛出本地路径文件不存在的错误，本质是pip在匹配安装包时，优先命中了指向本地路径的分发地址，没有走Artifactory远程源的匹配逻辑。

排查步骤 #

• 检查pip配置是否正确
  执行pip config list查看所有生效的pip配置：
  1. 确认你配置的Artifactory源地址是PyPI类型仓库的simple接口，格式应为https://<Artifactory域名>/artifactory/api/pypi/<仓库名>/simple/，末尾斜杠不可省略
  2. 排查是否存在find-links、extra-index-url配置指向本地目录，这类配置的优先级会高于远程索引源，会导致pip优先查找本地路径的包
• 检查Artifactory部署结果是否符合要求
  登录Artifactory后台确认：
  1. 你的上传路径/包名/版本号/xxx.whl符合PyPI仓库的目录规范，wheel包确实存在于对应路径下
  2. wheel包的命名符合PEP规范，包含正确的Python版本、平台标记，比如通用包后缀应为py3-none-any.whl，如果标记和你当前的运行环境不匹配，pip会跳过远程包，继续查找其他源的匹配包
• 检查安装命令的写法
  如果你执行的是pip install xxx.whl，该命令会默认优先查找本地当前目录下的对应文件，不会走远程索引查找，正确写法应该是pip install <包名>或者pip install <包名>==<指定版本号>

解决方案 #

• 如果是配置了本地源优先级更高，可以修改pip.conf移除本地路径配置，或者执行安装时加上参数--index-url <你的Artifactory源地址> --no-index，强制pip仅从Artifactory源查找包
• 如果是wheel包标记错误，重新构建符合环境要求的wheel包后重新上传即可
• 如果是Artifactory的PyPI索引未及时更新，手动触发对应仓库的索引重建，等待索引同步完成后再尝试安装
• 安装时可以加上-v参数，查看pip的完整索引匹配日志，进一步定位跳过远程包的原因

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