{
  "id": "cicd/github-actions-required-check-not-found",
  "signature": "Error: Required check 'ci / test (node-16)' was not found in the workflow. The check must be defined in the repository's workflow configuration.",
  "signature_zh": "错误：在流程中未找到必需的检查项 'ci / test (node-16)'。该检查项必须在仓库的工作流配置中定义。",
  "regex": "Required check '.*' was not found in the workflow",
  "domain": "cicd",
  "category": "config_error",
  "subcategory": null,
  "root_cause": "A required status check configured in branch protection rules references a check name that does not match any job in the current workflow files, often due to renaming a job or changing the workflow filename.",
  "root_cause_type": "generic",
  "root_cause_zh": "分支保护规则中配置的必需状态检查引用了当前工作流文件中不存在的检查名称，通常是因为重命名了任务或更改了工作流文件名。",
  "versions": [
    {
      "version": "GitHub Actions",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "GitHub Enterprise Server 3.8",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "GitHub.com (2024)",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "The branch protection rule is static and must be updated manually to match the workflow.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Branch protection rules apply to all branches matching a pattern, not to individual branches.",
      "fail_rate": 0.85,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "The required check name must exactly match the job name in the workflow, including matrix axes.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Update the branch protection rule to use the correct check name: Go to Settings > Branches > Edit protection rule for the branch, and update the 'Status checks found in last week for this repository' list with the correct job name.",
      "success_rate": 0.95,
      "how": "Update the branch protection rule to use the correct check name: Go to Settings > Branches > Edit protection rule for the branch, and update the 'Status checks found in last week for this repository' list with the correct job name.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Rename the job in the workflow file to match the required check name exactly, including matrix strategy labels.",
      "success_rate": 0.85,
      "how": "Rename the job in the workflow file to match the required check name exactly, including matrix strategy labels.",
      "condition": "",
      "sources": []
    },
    {
      "action": "Temporarily disable the required check in branch protection to allow merging, then correct the workflow and re-enable the check.",
      "success_rate": 0.8,
      "how": "Temporarily disable the required check in branch protection to allow merging, then correct the workflow and re-enable the check.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "Update the branch protection rule to use the correct check name: Go to Settings > Branches > Edit protection rule for the branch, and update the 'Status checks found in last week for this repository' list with the correct job name.",
    "Rename the job in the workflow file to match the required check name exactly, including matrix strategy labels.",
    "Temporarily disable the required check in branch protection to allow merging, then correct the workflow and re-enable the check."
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-status-checks",
  "official_doc_section": null,
  "error_code": "REQUIRED_CHECK_NOT_FOUND",
  "verification_tier": "ai_generated",
  "confidence": 0.88,
  "fix_success_rate": 0.9,
  "resolvable": "true",
  "first_seen": "2024-01-10",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}