pipenv安装GitLab私有PyPI源包成功但锁定步骤失败如何解决

• 临时指定的索引源不作用于锁定阶段：执行pipenv install时附加的--index参数仅对当前安装步骤生效，执行依赖锁定时，pipenv只会读取Pipfile中配置的源地址扫描包版本，未在Pipfile中登记的私有GitLab源不会被访问，自然检索不到对应包版本。
• 私有源权限缺失：GitLab私有PyPI registry需要身份认证才可访问包列表，若Pipfile中配置的源地址未携带认证信息、或本地环境未配置全局PyPI认证参数，锁定阶段请求源时会被拦截，返回空的版本列表。
• 旧版本pipenv缺陷：2021.11.15版本的pipenv存在多源解析逻辑bug，针对指定了私有源的包，锁定时可能错误优先请求公共PyPI源，导致检索失败。
• 包名大小写不匹配：GitLab的PyPI registry对包名大小写敏感，若安装时输入的包名与Pipfile中自动写入的包名大小写不一致，锁定阶段检索时会匹配不到对应包。

• 补充Pipfile私有源配置
  在Pipfile中添加私有GitLab源的登记段，示例如下：

[[source]]
url = "https://<认证信息>@<my-gitlab-instance>/api/v4/projects/<my-project-id>/packages/pypi/simple"
verify_ssl = true
name = "gitlab_private"

其中<认证信息>可替换为gitlab用户名:个人访问令牌，避免请求时权限不足。
同时修改Pipfile中对应私有包的声明，指定源关联：

[packages]
<my-python-package> = {version = "*", index = "gitlab_private"}

• 开启调试日志定位问题
  执行带详细日志的锁定命令，查看请求的源地址、返回状态：
  pipenv lock -v
  重点检查日志中检索时请求的URL是否为私有GitLab源地址，是否存在401、404等错误码。
• 验证私有源可用性
  直接通过curl请求私有源下对应包的列表，确认源端包存在且可访问：
  curl -u <gitlab用户名>:<个人访问令牌> https://<my-gitlab-instance>/api/v4/projects/<my-project-id>/packages/pypi/simple/<my-python-package>/
  若返回结果为空，说明GitLab端的包上传配置有误，需检查包是否正确发布到对应项目的PyPI registry。
• 升级pipenv版本
  2021.11.15版本存在多个私有源适配bug，直接升级到最新稳定版即可规避原生缺陷：
  pip install --upgrade pipenv

内容的提问来源于stack exchange，提问作者ben-g-