使用@semantic-release/git操作GitLab保护分支遇权限问题求解决方案

核心原因 #

@semantic-release/git插件的工作机制是直接推送提交（比如更新CHANGELOG、版本号）到目标分支，而你当前的master分支设置了「禁止任何人推送和合并」，哪怕是维护者也只能通过MR合并，直接推送操作会被GitLab拦截，这和是否开启强制推送无关。

具体解决方案 #

方案1：调整分支保护规则，允许指定用户/令牌直接推送 #

• 进入GitLab项目的「设置」->「仓库」->「受保护分支」
• 找到master分支的保护规则，点击「编辑」
• 在「允许推送」选项中，添加你使用的访问令牌对应的用户（或该用户所属的维护者组）
• 保存规则后，重新运行semantic-release流程

方案2：修改semantic-release配置，避免直接推送到受保护分支 #

如果不想改动分支保护规则，可以调整插件行为，改为生成变更文件后通过MR提交到master分支：

• 配置示例（在.releaserc.json中修改）：

{
  "plugins": [
    "@semantic-release/commit-analyzer",
    "@semantic-release/release-notes-generator",
    ["@semantic-release/git", {
      "assets": ["CHANGELOG.md", "package.json"],
      "message": "chore(release): ${nextRelease.version}\n\n${nextRelease.notes}"
    }],
    ["@semantic-release/gitlab", {
      "mergeRequest": true,
      "mergeRequestTitle": "chore(release): ${nextRelease.version}"
    }]
  ]
}

这样semantic-release会生成变更提交并创建MR，由维护者手动或自动合并到master分支，符合你的分支保护规则。

方案3：使用具备对应权限的令牌 #

确保你使用的访问令牌属于项目维护者以上角色，并且在令牌权限中勾选了「仓库写入权限」。CI_JOB_TOKEN默认权限较低，无法直接推送受保护分支，建议使用个人访问令牌或项目访问令牌。

关键注意点 #

• 强制推送权限只针对分支覆盖操作，不影响GitLab的受保护分支推送限制
• 分支保护的「仅允许维护者合并」是指通过MR合并，直接推送属于独立操作，不受该规则的允许范围覆盖

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