GitHub Action中Twine上传GCP包遇dist参数缺失报错问题

可能的原因及对应解决建议 #

1. 目标wheel文件在Action环境中不存在 #

虽然你写的路径和本地一致，但GitHub Action的运行环境是全新的，很可能没有执行生成wheel的步骤，或者生成的文件路径和预期不符。

• 解决：在twine上传命令前，添加目录检查命令，确认文件存在：

  ls -la ./target/wheels/
  

  如果输出里没有file.whl，先确保Action中包含了构建wheel的步骤，比如：

  pip wheel . --wheel-dir ./target/wheels/
  

  或者用setup.py构建：

  python setup.py bdist_wheel --dist-dir ./target/wheels/
  

2. 工作目录不匹配 #

GitHub Action默认的工作目录是仓库根目录，但如果你的构建步骤是在子目录执行的，相对路径./target/wheels/就会指向错误的位置。

• 解决：
  • 添加pwd命令查看当前工作目录，确认路径是否正确：

    pwd
    

  • 如果需要切换工作目录，在Action的step中指定working-directory字段：

    - name: Upload to GCP Artifactory
      working-directory: ./your-subdirectory
      run: twine upload --repository-url https://gcp-artifactory/project/ -u _json_key -p "${{ secrets.GCP_CREDENTIALS }}" ./target/wheels/file.whl
    

  • 或者直接使用绝对路径，比如${{ github.workspace }}/target/wheels/file.whl（github.workspace是Action内置的仓库根目录变量）。

3. 命令参数的引号转义问题 #

在GitHub Action的YAML配置中，直接使用带引号的参数可能被YAML解析器转义，导致twine无法正确识别最后一个文件路径参数，误以为缺少dist参数。

• 解决：
  • 用环境变量传递敏感信息，避免引号冲突：

    - name: Upload to GCP Artifactory
      run: twine upload --repository-url https://gcp-artifactory/project/ -u _json_key -p "$GCP_CREDENTIALS" ./target/wheels/file.whl
      env:
        GCP_CREDENTIALS: ${{ secrets.GCP_CREDENTIALS }}
    

  • 或者把命令拆分成多行，用反斜杠换行，让参数更清晰：

    - name: Upload to GCP Artifactory
      run: |
        twine upload \
          --repository-url https://gcp-artifactory/project/ \
          -u _json_key \
          -p "${{ secrets.GCP_CREDENTIALS }}" \
          ./target/wheels/file.whl
    

4. twine版本不一致 #

本地和Action环境中的twine版本差异，可能导致参数解析逻辑不同。

• 解决：在Action中指定安装和本地一致的twine版本：

  pip install twine==4.0.2
  

  替换成你本地twine --version输出的版本号。

内容的提问来源于stack exchange，提问作者Duany Baró Menéndez