GitLab流水线上传PyPI包时TWINE_REPOSITORY_URL配置错误求助

核心问题分析 #

你遇到的500错误是因为TWINE_REPOSITORY_URL配置错误——用了GitLab包仓库的Web页面地址，而非PyPI仓库的API端点，导致twine无法正确与GitLab的包管理API交互。另外硬编码密码的做法既不安全，也可能存在权限问题。

修正步骤及配置示例 #

1. 替换正确的仓库API地址
   GitLab PyPI仓库的标准API格式为：

https://gitlab.com/api/v4/projects/<你的项目ID>/packages/pypi

你可以在项目的「Packages & Registries」→「PyPI」页面找到这个地址，或者通过项目主页的「设置」→「通用」获取项目ID。

2. 使用GitLab CI内置认证变量
   放弃硬编码密码，改用GitLab CI提供的CI_JOB_TOKEN进行认证，无需手动创建用户密码，且权限更贴合流水线场景：

• TWINE_USERNAME固定为gitlab-ci-token
• TWINE_PASSWORD使用内置变量$CI_JOB_TOKEN

3. 修改后的完整.gitlab-ci.yml配置

variables:
  TWINE_REPOSITORY_URL: "https://gitlab.com/api/v4/projects/<你的项目ID>/packages/pypi"
  TWINE_USERNAME: "gitlab-ci-token"
  TWINE_PASSWORD: "$CI_JOB_TOKEN"

stages:
  - build

build-job:
  stage: build
  image: python:3.11-bullseye
  # only:
  #   - tags
  script:
    - echo "Compiling the code..."
    - pip install twine wheel
    - python setup.py sdist bdist_wheel
    - twine upload dist/* --verbose  # 添加--verbose方便排查后续问题
    - echo "Compile complete."

额外注意事项 #

• 确保项目的「设置」→「CI/CD」→「权限」中，流水线权限已勾选「允许流水线访问GitLab API」
• 如果需要发布到公开PyPI，才用pypi.org的地址，但你的场景是GitLab私有仓库，所以必须用上述API地址
• 建议取消注释only: - tags，只在打标签时触发发布，避免每次提交都执行上传

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