Github Actions创建Release时未触发，如何排查事件问题？

常见原因与排查步骤 #

1. 检查Token的触发限制（最可能的原因） #

GitHub内置的GITHUB_TOKEN有安全限制：由它触发的事件不会触发其他工作流，目的是避免循环执行。你当前创建Release使用的是这个内置Token，这会导致监听release事件的工作流无法被触发。

• 解决方法：
  1. 生成一个带有repo权限的Personal Access Token (PAT)
  2. 将该PAT添加到仓库的Secrets中（例如命名为REPO_PAT）
  3. 修改创建Release的步骤，替换Token：

     - name: Create release
       uses: thomaseizinger/create-release@master
       env:
         GITHUB_TOKEN: ${{ secrets.REPO_PAT }}
       with:
         target_commitish: ${{ github.event.pull_request.merge_commit_sha }}
         tag_name: ${{ env.RELEASE_VERSION }}
         name: ${{ env.RELEASE_VERSION }}
         body: ${{ steps.changelog_reader.outputs.changes }}
         draft: false
         prerelease: false
     

2. 验证Release事件类型匹配 #

• 确认创建的Release是直接发布的正式版本：检查仓库Release页面，确保该Release不是草稿、非预发布状态，且是直接创建发布（而非从草稿转为发布）。
• 若Release是从草稿发布的，触发的事件是released，但你已尝试过该类型，因此重点仍在Token限制。

3. 查看工作流触发历史 #

• 进入仓库Actions页面，点击左侧目标工作流Attach package to release assets，查看是否有被跳过的运行记录。GitHub会标注触发失败的具体原因（如权限限制）。
• 检查仓库Settings > Actions > General，确保工作流触发权限未被禁用，确认Allow all actions and reusable workflows选项已开启。

4. 验证工作流本身逻辑 #

• 利用目标工作流的workflow_dispatch配置，手动触发一次运行，确认工作流内部的打包、上传资产等逻辑能正常执行。若手动运行正常，说明问题仅出在事件触发环节。

5. 检查创建Release的工作流日志 #

• 查看创建Release的工作流运行日志，确认thomaseizinger/create-release步骤成功完成，且输出的Release状态为published，无异常报错。

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