使用分支引用和作业名称无法从GitLab CI流水线获取最新制品

可能的原因及排查方案 #

1. 作业未正确生成并归档制品 #

尽管作业状态显示为success，但需确认作业的.gitlab-ci.yml配置中是否正确声明了制品规则，且目标文件确实存在：

build-debug-all:
  stage: build-debug
  script:
    - # 你的构建执行命令
  artifacts:
    paths:
      - include/
      - lib/
    # 注意检查是否有only/except、rules等规则限制制品生成

如果artifacts配置缺失、路径错误，或被条件规则限制未生成制品，API会因找不到资源返回404。

2. 作业名的精确匹配问题 #

GitLab API对作业名的匹配是大小写敏感的，需确保请求中job参数的值与GitLab返回的name字段完全一致，包括连字符、下划线等符号的使用。比如作业名是build-debug-all，不能写成Build-Debug-All或build_debug_all。

3. 制品已被清理或过期 #

检查项目的制品保留策略：

• 进入项目设置 → CI/CD → 制品
• 确认保留时间设置是否合理，避免作业完成后制品被自动清理
• 同时可在作业详情页查看是否有「下载制品」按钮，若没有则说明制品已被删除

4. 项目ID的格式错误 #

确保请求中的<PROJECT-ID>是项目的数字ID，而非项目路径（如my-group/my-project）。若使用项目路径，需进行URL编码后使用，例如：

# 正确使用数字ID的示例
https://gitlab.example.com/api/v4/projects/123/jobs/artifacts/main/download?job=build-debug-all

# 使用项目路径时需编码
https://gitlab.example.com/api/v4/projects/my-group%2Fmy-project/jobs/artifacts/main/download?job=build-debug-all

5. 流水线类型不匹配 #

如果作业属于合并请求流水线而非分支流水线，直接使用分支名main无法匹配，需改用MR的引用路径，例如refs/merge-requests/123/head替代URL中的<TAG|BRANCH>部分。

快速验证方式 #

先通过GitLab UI手动下载该作业的制品：

1. 进入项目CI/CD → 作业页面
2. 找到main分支下的build-debug-all作业
3. 点击「下载制品」按钮，复制浏览器地址栏的URL，与你构造的API请求对比，即可快速确认请求格式是否正确。

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