Semantic Release GitHub Action因保护分支无法发布变更求助

问题原因 #

当Semantic Release通过@semantic-release/git插件向main分支推送变更（比如更新CHANGELOG、版本号文件）时，GitHub分支保护规则要求必须通过所有状态检查，但这次直接推送的操作没有触发对应的检查流程，因此被远程仓库拒绝。

解决方案 #

方案1：通过GitHub API提交变更（推荐）

修改release.config.cjs中的@semantic-release/git插件配置，让它使用GitHub API提交变更，而非直接执行git push，这样可以自动满足分支保护的状态检查要求：

const config = {
    branches: ['main'],
    repositoryUrl: 'git+https://github.com/tal-rofe/demo',
    plugins: [
        [
            '@semantic-release/commit-analyzer',
            {
                preset: 'angular',
                releaseRules: [
                    { type: 'feat', release: 'minor' },
                    { type: 'fix', release: 'patch' },
                    { type: 'perf', release: 'patch' },
                    { type: 'breaking', release: 'major' },
                ],
            },
        ],
        '@semantic-release/release-notes-generator',
        '@semantic-release/changelog',
        // 修改@semantic-release/git插件配置
        ['@semantic-release/git', {
            assets: ['CHANGELOG.md', 'package.json'], // 根据你的项目调整需要提交的文件
            message: 'chore(release): ${nextRelease.version}\n\n${nextRelease.notes}',
            useGitHubApi: true // 关键配置：启用GitHub API提交
        }],
        '@semantic-release/github',
        ['@semantic-release/npm', { npmPublish: false }],
    ],
};

module.exports = config;

确保你的SEMANTIC_RELEASE_GH_TOKEN拥有repo权限（公开仓库需public_repo权限），API才能正常创建提交。

方案2：允许令牌跳过分支保护检查

1. 进入仓库Settings → Branches，找到main分支的保护规则，点击Edit
2. 滚动到「Allow specified actors to bypass required pull requests」选项并勾选
3. 在输入框中添加SEMANTIC_RELEASE_GH_TOKEN对应的用户（个人令牌填你的GitHub用户名，GitHub App令牌填App名称）
4. 保存规则
   这样Semantic Release使用该令牌推送时，会直接绕过状态检查要求。

方案3：通过PR完成变更推送（流程复杂，适合严格合规场景）

调整工作流，让Semantic Release先将变更推送到临时分支，再自动创建PR到main分支，等PR通过状态检查后再合并：

• 修改GitHub Action触发逻辑，避免直接在main分支推送
• 额外添加创建PR的步骤（可使用actions/create-pull-request插件）
  此方法流程繁琐，仅在无法使用前两种方案时考虑。

验证 #

修改配置后，重新推送代码到main分支，Semantic Release应能正常完成版本发布并推送变更到main分支。

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