Goreleaser在GitLab私有仓库发布制品失败求助

问题核心 #

Goreleaser默认采用User/Project_Name格式构造GitLab API请求，但该格式在私有项目场景下会触发GitLab API路径解析错误，实际是404（项目未找到），但返回了401权限错误。

解决方案 #

1. 在Goreleaser配置中指定项目ID

直接在.goreleaser.yaml中添加scm配置段，明确指定GitLab项目ID，彻底避免路径格式解析问题：

project_name: PROJECTNAME
version: 1

# 新增SCM配置，替换id为你的项目实际ID（可在GitLab项目主页「设置」→「通用」中找到）
scm:
  provider: gitlab
  owner: night-gold
  name: PROJECT
  id: "你的项目ID"

before:
  hooks:
    - go mod tidy

# 其余原有配置不变...

GitLab API使用项目ID的请求格式不会出现路径匹配问题，能准确定位到私有项目。

2. 验证GITLAB_TOKEN的权限与配置

• 确认生成的token已勾选api权限，且所属角色为项目的Maintainer或Owner；
• 检查GitLab CI变量中GITLAB_TOKEN已正确设置，且开启Protected和Masked（确保tag流水线能读取该变量）。

3. 处理项目路径的URL编码（若项目名含特殊字符）

如果项目名包含斜杠、空格等特殊字符，需对路径进行URL编码，可在scm配置中直接指定编码后的项目URL：

scm:
  provider: gitlab
  url: "https://gitlab.com/night-gold%2FPROJECT"  # 替换为你的编码后路径

额外验证 #

确保GitLab CI配置中的GIT_DEPTH: 0已生效，Goreleaser需要完整的Git tag历史来完成发布流程。

内容的提问来源于stack exchange，提问作者night-gold