GitLab CI上传文件至包注册表时提示‘文件缺失’问题求助

可能的原因及解决步骤 #

1. 校验PACKAGE_REGISTRY_URL路径格式 #

GitLab通用包仓库的上传URL必须包含版本标识（如${CI_COMMIT_TAG}），正确格式示例：

${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/generic/${RELEASENAME}/${CI_COMMIT_TAG}/${RELEASENAME}.tgz

若URL缺少版本层级或路径结构错误，GitLab会判定为“文件缺失”。

验证方法：在脚本中新增打印语句确认URL：

- echo "上传URL：${PACKAGE_REGISTRY_URL}/${RELEASENAME}.tgz"

2. 确认RELEASENAME变量一致性 #

从ls输出可见本地文件为output.tgz，需确保RELEASENAME变量值确实为output，且上传URL中的${RELEASENAME}未被意外覆盖。

验证方法：添加变量打印：

- echo "RELEASENAME：${RELEASENAME}"
- echo "本地文件路径：${CI_PROJECT_DIR}/${RELEASENAME}.tgz"

3. 修正curl命令的引号写法 #

脚本中使用的"转义引号可能导致shell解析异常，直接使用标准引号格式：

script:
  - tar cvzf "${CI_PROJECT_DIR}/${RELEASENAME}.tgz" build
  - ls -alh "${CI_PROJECT_DIR}/${RELEASENAME}.tgz"
  - curl --header "JOB-TOKEN: ${CI_JOB_TOKEN}" --upload-file "${CI_PROJECT_DIR}/${RELEASENAME}.tgz" "${PACKAGE_REGISTRY_URL}/${RELEASENAME}.tgz"

4. 检查作业权限配置 #

• 进入项目设置→权限→包仓库，确认当前作业角色（如开发者、维护者）拥有“上传包”权限；
• 进入项目设置→CI/CD→令牌范围，确保CI_JOB_TOKEN的权限范围包含“包仓库”。

5. 简化命令调试 #

上传测试文件排除本地文件问题：

- touch test.tgz
- curl --header "JOB-TOKEN: ${CI_JOB_TOKEN}" --upload-file test.tgz "${PACKAGE_REGISTRY_URL}/test.tgz"

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