私有Python仓库安装包时install_requires依赖无法找到的问题

一、配置依赖从PyPI拉取的方法 #

1. 安装命令层面调整 #

使用--extra-index-url参数指定PyPI作为备用仓库，让pip优先从私有仓库查找包，找不到时自动转向PyPI拉取：

pip install --index-url https://repo.example.com/py --extra-index-url https://pypi.org/simple example-package

--index-url将私有仓库设为优先源，--extra-index-url补充PyPI作为 fallback 源，直接解决私有仓库无公共依赖的问题。

2. 包配置层面优化（可选） #

如果希望在包的配置中明确依赖源，推荐用pyproject.toml替代setup.py（符合现代Python包规范），添加仓库配置：

[project]
name = "example-package"
version = "0.1.0"
description = "This is an example package"
authors = [
  { name="John Doe", email="john-doe@example.com" }
]
license = { text = "Private" }
dependencies = [
  "pydantic",
  "requests",
  "xmltodict"
]

[tool.setuptools]
packages = ["example_package"]
include-package-data = true
platforms = ["linux"]

[tool.pip.index]
index-url = "https://repo.example.com/py"
extra-index-url = ["https://pypi.org/simple"]

注意：这种方式需要确保pip版本在21.0及以上，才能读取pyproject.toml中的仓库配置。

二、其他可能的故障原因 #

• 私有仓库网络受限：私有仓库所在环境无法访问PyPI，即使指定--extra-index-url也无法拉取公共依赖
• 私有仓库同步异常：私有仓库未正确同步PyPI上的pydantic等公共包，导致依赖查找失败
• 本地pip配置冲突：本地pip.conf/pip.ini文件设置了全局index-url，覆盖了命令行参数的配置
• 私有仓库权限/地址错误：命令行中的私有仓库地址有误，或当前用户无访问权限，导致pip无法正常检索包信息
• Python版本不兼容：当前使用的Python版本不在pydantic支持范围内，私有仓库和PyPI中均无匹配的兼容版本
• pip版本过旧：旧版本pip对--extra-index-url的依赖解析逻辑存在bug，升级pip到最新版本可解决

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