GitHub Actions提交失败：仓库写入权限未授予（403错误）

可能的根因 #

1. Git远程URL错误：提交时使用的仓库URL格式错误（比如你报错中的https:/github/<repo>少了一个斜杠），或者未携带授权token
2. Workflow权限未正确配置：全局设置了读写权限，但工作流局部配置覆盖为只读
3. 分支保护规则拦截：dev分支开启了强制PR、状态检查等保护规则，Action的bot账号无法绕过
4. Git提交配置缺失：未设置提交用的用户名和邮箱，导致Git操作失败

修复方案 #

1. 修正Git远程URL并携带授权Token #

在提交步骤前，重新设置远程仓库URL，将GITHUB_TOKEN嵌入其中，确保授权有效：

- name: Update remote repo URL with token
  run: git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git

注意URL必须是完整的https://github.com/<owner>/<repo>.git格式，避免斜杠缺失这类低级错误。

2. 明确配置Workflow内容读写权限 #

即使仓库全局设置了读写权限，也要在工作流顶部显式声明权限，防止局部配置覆盖：

permissions:
  contents: write  # 授予内容读写权限，优先级高于全局设置

3. 配置Git提交身份信息 #

提交前必须设置有效的Git用户名和邮箱，否则Git会拒绝提交操作：

- name: Configure Git identity
  run: |
    git config --global user.name "GitHub Actions Bot"
    git config --global user.email "actions@github.com"

4. 调整分支保护规则（若有） #

如果dev分支开启了分支保护，需添加例外规则允许Action bot绕过：

• 进入仓库Settings → Branches → 找到dev分支的保护规则
• 勾选Allow specified actors to bypass required pull requests
• 添加github-actions[bot]到允许列表

5. 避免Action循环触发 #

提交时在commit message中加入[skip ci]，防止新提交再次触发工作流导致循环：

- name: Commit version update
  run: |
    git add *.csproj
    git commit -m "Auto-increment version [skip ci]"
    git push origin dev

完整工作流示例片段 #

name: Auto Version Bump

on:
  push:
    branches: [ dev ]

permissions:
  contents: write

jobs:
  bump-version:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0  # 拉取完整提交历史，避免版本计数错误

      - name: Configure Git
        run: |
          git config --global user.name "GitHub Actions Bot"
          git config --global user.email "actions@github.com"
          git remote set-url origin https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }}.git

      - name: Increment csproj version
        run: |
          # 替换为你的版本升级逻辑，示例用提交计数作为修订号
          NEW_VERSION="1.0.$(git rev-list --count HEAD)"
          sed -i "s/<Version>.*<\/Version>/<Version>$NEW_VERSION<\/Version>/" YourProject.csproj

      - name: Push version update
        run: |
          git add YourProject.csproj
          git commit -m "Auto-bump version to $NEW_VERSION [skip ci]"
          git push origin dev

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