GitHub Actions Cron定时工作流不触发，手动触发workflow_dispatch正常

核心定位 #

手动触发正常但定时完全失效，说明脚本逻辑无问题，问题出在GitHub Actions定时触发的规则限制上，以下是针对性排查和解决步骤：

1. 确认工作流位于仓库默认分支 #

GitHub的schedule触发器仅对仓库默认分支中的工作流文件生效。如果工作流文件存放在非默认分支（如临时开发分支），哪怕已经合并，只要未设为默认分支，定时任务就不会触发。

• 操作路径：仓库「Settings」→「Branches」，确认默认分支为master（你的脚本基于该分支操作），且.github/workflows/下的工作流文件存在于该分支。

2. 检查仓库Actions权限设置 #

确保未禁用定时任务的权限：

• 进入仓库「Settings」→「Actions」→「General」，拉至最下方的「Workflow permissions」，确认勾选了允许Actions创建提交的权限（至少保证contents: write权限开启，你手动能运行的话该权限大概率没问题，但建议核实）。
• 同时确认「Actions permissions」设置为「Allow all actions and reusable workflows」，避免权限拦截定时任务启动。

3. 唤醒休眠仓库 #

若仓库超过60天无任何活动（提交、PR、Issue等），GitHub会暂停定时工作流触发。解决方法：手动提交一次代码（如你之前手动触发的提交）即可唤醒定时任务。

4. 替换GITHUB_TOKEN为个人访问令牌（PAT，可选） #

少数场景下，定时触发时GITHUB_TOKEN会存在隐性权限限制，可尝试替换：

• 生成带repo权限的PAT：个人「Settings」→「Developer settings」→「Personal access tokens」→「Tokens (classic)」，勾选repo权限后生成令牌。
• 在仓库「Settings」→「Secrets and variables」→「Actions」中添加名为PAT的秘密变量，值为刚生成的令牌。
• 修改工作流的checkout步骤：

  - name: Checkout repository
    uses: actions/checkout@v4
    with:
      token: ${{ secrets.PAT }}
  

额外优化建议 #

• 脚本中的git pull --rebase origin master可能在出现冲突时失败，建议添加--autostash参数自动暂存本地修改：git pull --rebase --autostash origin master
• 可在提交前检查分支同步状态，避免无意义的失败：

  git fetch origin master
  if [ $(git rev-parse HEAD) != $(git rev-parse origin/master) ]; then
    git pull --rebase --autostash origin master
  fi
  

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