Error category

GitHub Actions Errors and Fixes

Troubleshoot GitHub Actions workflow failures, runner problems, queued jobs, secrets, permissions, dependency installs, and deployment automation errors.

This GitHub Actions troubleshooting hub collects real error signatures, quick fixes, common causes, and step-by-step debugging paths for developers who need a practical answer instead of a broad overview.

76 crawlable articles in this category. 33 additional records are indexed in JSON only (no standalone HTML route).

Browse GitHub Actions records in the data catalog — search JSON index entries, including data-only records without standalone HTML guides.

Troubleshooting overview

Start by matching the exact error message, then check the technology, environment, credentials, network path, and deployment context. The pages below are grouped so you can move from broad GitHub Actions symptoms to specific root-cause families without relying on client-side search.

Evidence labels are derived at build time from each Markdown record. Source-backed entries have public URLs under a Sources checked section, while partial-source entries expose public links without a complete source block.

GitHub Actions diagnostic workflow

  1. Copy the exact error signature and compare it with the page title, code block, and technology label.
  2. Check whether the failure is local, CI-only, deployment-only, provider-side, or account-specific.
  3. Collect non-secret versions, configuration names, request IDs, and timestamps before making changes.
  4. Review source-backed or partial-source pages first when the issue might depend on provider behavior or version-specific bugs.
  5. Apply the smallest reversible fix and rerun the same failing action.

Common error types

  • workflow failed
  • waiting for a runner
  • permission denied
  • secret not found
  • dependency install failed
  • job queued

Common causes

  • Source: https://github.com/actions/toolkit/issues/2417. The downloadTool() function in @actions/tool-cache accepts arbitrary URLs without validation, enabling SSRF attacks against cloud metadata services. Medium-High severity. Affects CI/CD pipeline security for teams using custom GitHub Actions. (1 page)
  • Found in actions/toolkit issue #2408 (2026-05-15). Bumping minimatch from v3 to v10 broke named export compatibility. Any GitHub Action using @actions/glob in ESM context will crash at runtime. CI/CD impact for teams using pinned actions. Category: GitHub Actions. (1 page)
  • GitHub issue #2408 on actions/toolkit, created 2026-05-15. Clear root cause: PR #2355 bumped minimatch v3→v10 but internal-pattern.js still uses named import { Minimatch }. minimmate v10 doesn't export Minimatch as named export, crashing ESM contexts. Impacts any ESM-based GitHub Action using @actions/glob. Not in covered-errors.md. (1 page)
  • 来源:GitHub Issues (POWERFULMOVES/PMOVES.AI#1566)。Bot 账号 github-actions[bot] 上报的定时检查发现 GH_PAT 已过期导致 pipeline 中断。这是一个通用模式:大量使用 GitHub Actions 的仓库都会面临 PAT 过期导致的部署阻塞。分类:GitHub Actions(CI/CD 失败直接影响付费团队交付)。 (1 page)
  • Fetched via normal_fetch from mickeygousset.com — detailed analysis of two distinct errors when permissions scope excludes contents: read. Root cause: specifying any permissions key overrides defaults, leaving unspecified scopes at none. Public repos exempt; private/internal repos require explicit contents: read. Also affects GitHub Enterprise Cloud & Managed Users. Duplicate check against covered-errors.md: no exact match — existing entry covers generic 'permission denied publickey', this is a specific GITHUB_TOKEN scope defaulting-to-none issue unique to workflows with custom permissions blocks. (1 page)
  • Found in open GitHub issue #2386 on actions/checkout repo (opened Mar 12, 2026). Persistent blocker for teams using self-hosted or container-based runners with token-authenticated repo pushes. 13+ comments, no accepted workaround. Blocking CI/CD for paying team accounts strongly impacts commercial value. Category 'GitHub Actions' is exact match. (1 page)

Related technologies

  • GitHub Actions (109 pages)
  • self-hosted runners
  • Docker
  • Node.js
  • Vercel

Troubleshooting clusters

  • Runner and queue failures
  • CI/CD build errors
  • Secret and permission errors
  • Dependency install failures
  • Matrix and cancellation issues
  • Deployment workflow errors

Latest pages in this category

Representative source-backed errors

These entries include public source URLs in the imported page body. Use them first when you need evidence for provider behavior, SDK regressions, or version-specific failures.

Safe debugging checklist

  • Do not paste API keys, tokens, cookies, private repository snippets, or customer data into public issues.
  • Keep a rollback path before changing credentials, billing limits, DNS, CI secrets, or production deploy settings.
  • Prefer official documentation and source-backed entries over broad guesses when the error affects paid APIs or production deploys.

Top fixes

High-intent troubleshooting topics

  • how to fix GitHub Actions errors
  • GitHub Actions error fix
  • GitHub Actions troubleshooting
  • GitHub Actions authentication failed
  • GitHub Actions timeout
  • GitHub Actions permission denied
  • GitHub Actions deployment failed
GitHub Actions GitHub Actions

GitHub Actions Permission Denied EACCES — Resource Not Accessible by Integration

Fix GitHub Actions workflow permission errors including GITHUB_TOKEN scope issues, fork PR restrictions, and runner filesystem ownership conflicts from root vs non-root step runs Includes evidence for GitHub Actions troubleshooting demand.

Error: HttpError: Resource not accessible by integration OR remote: Permission to user/repo.git denied to github-actions[bot] OR Error: EACCES: permission denied, open '/home/runner/.npm/_cacache/...'
GitHub Actions GitHub Actions

GitHub Actions Permission Denied: GITHUB_TOKEN Lacks Write Access for Workflows

Fix GitHub Actions workflows failing due to default GITHUB_TOKEN having only read-only access, preventing PR creation, branch pushes, or script execution Includes evidence for GitHub Actions troubleshooting demand.

github-actions[bot] denied permission / GITHUB_TOKEN lacks repository write access
GitHub Actions GitHub Actions

GitHub Actions Checkout Fails: repository not found / terminal prompts disabled

Fix actions/checkout action failing with two new error messages after workflow permission changes restrict GITHUB_TOKEN contents scope to none Includes evidence for GitHub Actions troubleshooting demand.

repository 'https://github.com/...' not found OR could not read Username for 'https://github.com': terminal prompts disabled — actions/checkout GITHUB_TOKEN contents scope set to none
GitHub Actions GitHub Actions

GitHub Actions SSH Deployment Permission Denied (publickey) — ED25519 vs RSA Key Format Mismatch

Developer's GitHub Actions workflow fails with SSH permission denied during git clone or deploy step. Root cause often involves mismatched key formats (ED25519 public key vs RSA private key in secrets), truncated PEM in secret values, or ssh-agent not initialized in runner environment. Includes evidence for GitHub Actions troubleshooting demand.

git@github.com: Permission denied (publickey). Load key '/github/home/.ssh/id_ed25519': invalid format
GitHub Actions GitHub Actions

GitHub Actions Cache Service v2 Migration Breaking Workflows — Cache Not Found

Fix GitHub Actions workflows failing to restore build caches after GitHub's February 2025 cache service v2 migration, especially on self-hosted runners with outdated versions. Includes evidence for GitHub Actions troubleshooting demand.

Cache not found for input keys: generated-repository-lib-* — GitHub Actions Actions Cache v2 service migration causing intermittent cache restore failures
GitHub Actions GitHub Actions

GitHub Actions Permission Denied When Pushing to Repo — GITHUB_TOKEN vs PAT Mismatch

GitHub Actions workflow fails with 403 permission denied when trying to commit/push changes. PAT works locally but GITHUB_TOKEN fails in CI. Developer needs workflow-level permissions fix. Includes evidence for GitHub Actions troubleshooting demand.

remote: Permission to OWNER/REPO.git denied to github-actions[bot]. fatal: unable to access: The requested URL returned error: 403
GitHub Actions GitHub Actions

GitHub Actions Workflow Stuck Waiting for Runner: Self-Hosted Runner Idle But Not Picking Up Jobs + Permission Denied EACCES

Fix GitHub Actions jobs stuck in queued state — self-hosted runners not picking up jobs due to permission denied on docker.sock, ARC non-root container EACCES errors, or org repository permissions blocking runner group Includes evidence for GitHub Actions troubleshooting demand.

Waiting for a runner to pick up this job... | dial unix /var/run/docker.sock: connect: permission denied | Error: EACCES: permission denied, open '/__w/_temp/_runner_file_commands/set_env_*'
GitHub Actions GitHub Actions

Self-hosted GitHub Actions runner EACCES permission denied in container checkout

Fix self-hosted Linux runner permissions error when running GitHub Actions workflows inside containers — checkout step throws permission denied saving state files Includes evidence for GitHub Actions troubleshooting demand.

Error: EACCES: permission denied, open '/__w/_temp/_runner_file_commands/save_state_*'
GitHub Actions GitHub Actions

GitHub Actions GITHUB_TOKEN Secondary Rate Limit — Concurrent Requests Exceeded

Resolve secondary rate limit error in GitHub Actions workflow caused by excessive concurrent API calls; understand point calculation for secondary limits Includes evidence for GitHub Actions troubleshooting demand.

Secondary rate limit triggered: too many concurrent requests (exceeds 100 concurrent limit) or 900 points/minute REST endpoint threshold
GitHub Actions GitHub Actions

GitHub Actions Secret Not Found on Pull Request Workflows

Fix GitHub Actions workflows failing on pull requests due to repository secrets not being accessible in fork/PR context, while succeeding on direct branch pushes Includes evidence for GitHub Actions troubleshooting demand.

Workflow succeeds on main but fails on PR with 'secret not found' error
GitHub Actions GitHub Actions

GitHub Actions npm ci Lockfile Out of Sync After Dependency Update

Fix npm ci lockfile resolution errors blocking GitHub Actions CI/CD pipeline Includes evidence for GitHub Actions troubleshooting demand.

npm ERR! Could not resolve dependency: peer react@"^18.0.0" from @mui/material@5.16.0 npm ERR! Fix the upstream dependency conflict, or revert to the locked version
GitHub Actions GitHub Actions

GitHub Actions Docker Push Permission Denied / Unauthorized Fix (2026)

Fix Docker registry authentication failures in GitHub Actions workflow that block deployment pipelines for teams using private registries Includes evidence for GitHub Actions troubleshooting demand.

permission denied OR unauthorized: authentication required — Docker image push fails in GitHub Actions CI/CD pipeline due to GITHUB_TOKEN permissions configuration
GitHub Actions GitHub Actions

GitHub Actions Permission Denied When Pushing Back — PAT Bypass Required

Fix permission denied errors in GitHub Actions workflows when attempting to commit and push changes back to repository. Includes evidence for GitHub Actions troubleshooting demand.

Permission denied when pushing from GitHub Actions workflow; requires Personal Access Token workaround
GitHub Actions GitHub Actions

GitHub Actions JIT Token Expires During Long Sequential Workflow Runs

Fix self-hosted runner JWT authentication tokens expiring during long sequential workflow runs (hours-long pipelines), causing intermittent runner registration failures mid-pipeline Includes evidence for GitHub Actions troubleshooting demand.

JIT Token Expiration with Long-Running Sequential Workflows

Browse all GitHub Actions troubleshooting pages

Continue through the full static archive for this hub. Every listed page is crawlable and keeps its existing canonical URL.

Browse all GitHub Actions troubleshooting pages