GitHub Action私有仓库推送403权限问题及自触发规避咨询

一、修复"Write permission is not granted" 403错误 #

1. 显式配置Workflow权限 #

在你的Minifier Workflow配置文件（比如.github/workflows/minifier.yml）开头，添加permissions字段，明确授予内容写入权限：

name: Minifier Workflow
on:
  push:
    branches: [main]
  workflow_dispatch:

permissions:
  contents: write  # 必须显式声明，默认可能只有只读权限

很多新手容易漏掉这个配置，哪怕是私有仓库，默认的GITHUB_TOKEN权限也可能被限制为只读，必须主动设置写入权限。

2. 检查组织/仓库的全局权限设置 #

如果是组织旗下的私有仓库，还要确认组织层面没禁用Workflow的写入权限：

• 进入组织设置 → Actions → General → 找到"Workflow permissions"，选择"Read and write permissions"
• 仓库单独设置：仓库设置 → Actions → General → Workflow permissions，确保选中读写权限

3. 验证自定义PAT的权限（如果用了的话） #

要是你没使用默认的GITHUB_TOKEN，而是自己创建了个人访问令牌（PAT），得确认：

• PAT勾选了repo全权限
• 仓库的Secrets里正确添加了这个PAT，Workflow里的变量引用也没错（比如secrets.MY_CUSTOM_PAT）
• PAT没过期，有效期要足够长

4. 推送时指定正确的令牌 #

如果用默认GITHUB_TOKEN还是不行，可以尝试在git推送命令里直接使用自定义PAT：

git push https://${{ secrets.MY_CUSTOM_PAT }}@github.com/你的用户名/你的仓库名.git main

二、避免Workflow自触发 #

当Workflow提交压缩后的CSS文件时，会再次触发push事件，导致循环执行，有两种简单解决方式：

1. 提交信息加[skip ci]标记 #

在git提交时，给信息加上[skip ci]，GitHub会自动跳过这次提交的Workflow触发：

git commit -m "压缩CSS文件 [skip ci]"

这样Workflow生成的提交就不会触发自己。

2. 在触发条件里排除机器人提交 #

修改Workflow的on.push规则，过滤掉由github-actions[bot]创建的提交：

on:
  push:
    branches: [main]
    # 可选：只在source文件夹有变更时触发，减少不必要执行
    paths:
      - 'source/**'
    # 排除GitHub Actions机器人的提交
    if: github.event.commits[0].author.name != 'github-actions[bot]'
  workflow_dispatch:

这种方式不用改提交信息，自动过滤Workflow产生的推送。

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