GitHub Actions无法获取PR标签，提示‘非拉取请求’如何调试？

1. 确认工作流触发事件配置 #

检查你的工作流文件（.github/workflows/xxx.yml）的on字段，必须明确监听PR相关事件，比如：

on:
  pull_request:
    types: [opened, synchronize, labeled, unlabeled]

如果仅监听push或其他非PR事件，github.event.pull_request必然为空，日志会出现“Not a pull request”提示。

2. 验证工作流权限 #

确保工作流拥有读取PR数据的权限，在工作流文件中添加权限配置：

permissions:
  pull-requests: read

权限不足时，即便触发PR事件也无法获取标签信息。

3. 打印完整上下文排查问题 #

在工作流中添加步骤，打印完整的github事件上下文，确认是否包含pull_request字段：

- name: Print GitHub event context
  run: echo "${{ toJSON(github.event) }}"

通过输出能直观看到当前事件类型，以及pull_request下的标签数据是否存在。

4. 修正标签检查逻辑 #

确保标签检查代码正确解析标签数据，比如用jq工具来判断是否存在newFeature标签：

- name: Check for newFeature label
  id: check_label
  run: |
    HAS_LABEL=$(echo "${{ toJSON(github.event.pull_request.labels) }}" | jq -r '.[] | select(.name == "newFeature") | .name')
    if [ -n "$HAS_LABEL" ]; then
      echo "newFeature=true" >> $GITHUB_OUTPUT
    else
      echo "newFeature=false" >> $GITHUB_OUTPUT
    fi

避免直接用字符串匹配，JSON解析的方式更可靠。

5. 确认PR的状态与标签 #

手动检查目标PR是否确实添加了newFeature标签，且PR处于活跃状态（未合并、未关闭）。如果标签是在工作流触发后才添加的，需重新触发工作流（比如提交空改动、重新打标签）。

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