GitHub Actions标记依赖阻塞Issue时遇Not Found错误求助

以下是针对你遇到的问题的具体排查方向，按优先级排序：

• 权限不足
  用Nektos/Act测试时，默认使用的令牌权限有限，无法修改Issue标签。
  排查：运行Act时通过参数传入带repo权限的个人访问令牌：

  act -s GITHUB_TOKEN=你的个人访问令牌
  

  注意：令牌需要在GitHub个人设置里生成，勾选repo权限组，不要硬编码到配置文件中。

• Issue编号或仓库路径错误
  工作流中引用的Issue编号或仓库路径可能不匹配实际目标。
  排查：在工作流中添加调试步骤，打印关键上下文变量：

  - name: Debug context values
    run: |
      echo "Target Issue Number: ${{ github.event.issue.number }}"
      echo "Target Repository: ${{ github.repository }}"
  

  运行Act后检查输出，确保Issue编号是仓库中真实存在的，仓库格式为owner/repo-name；同时验证test-event.json中issue.number和repository.full_name字段是否正确。

• "blocked"标签未在仓库中创建
  如果目标仓库没有预先创建"blocked"标签，GitHub CLI执行添加标签命令时会返回"Not Found"。
  排查：手动进入仓库的Issues标签页确认标签存在，若不存在，可在工作流中添加前置步骤自动创建：

  - name: Ensure blocked label exists
    run: gh label create blocked --description "Issue blocked by in-progress tasks" --color "#d93f0b" --force
    env:
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  

• GitHub CLI命令参数错误
  命令格式不正确会导致无法定位到目标Issue。
  排查：先在本地用已登录的GitHub CLI测试命令，比如：

  gh issue edit 123 --add-label blocked --repo owner/your-repo
  

  若本地执行成功，说明工作流中的命令存在变量引用错误，比如漏写--repo参数，或者上下文变量引用错误。

• Act环境上下文变量注入异常
  Act对GitHub上下文变量的处理可能和线上环境有差异，导致仓库或Issue编号未正确传递。
  排查：在工作流的标签添加步骤中显式指定仓库参数：

  - name: Add blocked label to issue
    run: gh issue edit ${{ github.event.issue.number }} --add-label blocked --repo ${{ github.repository }}
    env:
      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
  

  同时确保运行Act时正确加载测试事件文件：act -e test-event.json

• 本地GitHub CLI配置异常
  即使版本正确，若本地CLI未登录目标账号或权限不足，也会触发错误。
  排查：运行gh auth status检查当前登录账号是否有权限操作目标仓库，若没有则执行gh auth login重新登录对应账号。

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