La operación fue cancelada en GitHub Actions
Última actualización
The operation was canceled significa que GitHub detuvo su job o step antes de que terminara, y lo hizo a propósito: una ejecución más reciente lo reemplazó, un job hermano falló, se alcanzó un timeout o alguien pulsó cancelar. Rara vez significa que su código sea incorrecto. Esta página enumera las causas por probabilidad y muestra cómo distinguirlas desde la página de la ejecución. El comportamiento procede de la referencia de sintaxis de workflows de GitHub, revisada en octubre de 2026.
El mensaje exacto
Error: The operation was canceled.
Variantes que puede ver junto a este mensaje:
Canceling since a higher priority waiting request for 'ci-refs/heads/main' exists
Error: The run was canceled by @username.
The runner has received a shutdown signal.
Revise las anotaciones en la parte superior del resumen de la ejecución. El texto suele indicar la causa.
Causa 1: concurrency con cancel-in-progress
Si un workflow declara concurrency con cancel-in-progress: true, al volver a hacer push se cancela la ejecución anterior del mismo grupo. El job cancelado registra The operation was canceled.
concurrency:
group: ci-${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
Es lo deseado para el CI de pull requests, pero no para despliegues ni jobs de publicación, donde cancelar a mitad de camino puede dejar las cosas a medias. Tenga en cuenta además la regla de GitHub: por defecto, una ejecución pending existente en el mismo grupo es sustituida por la nueva en cola, incluso sin cancel-in-progress. Eso es lo que significa el mensaje "higher priority waiting request".
Solución para despliegues:
concurrency:
group: deploy-production
cancel-in-progress: false
Con false, una ejecución avanza y otra espera; las ejecuciones en espera más antiguas siguen descartándose. Si necesita que todas las ejecuciones se completen, use nombres de grupo únicos por ejecución o una merge queue (véase merge queue de GitHub). Cancele solo en los jobs de CI:
concurrency:
group: ci-${{ github.ref }}
cancel-in-progress: ${{ github.event_name == 'pull_request' }}
Causa 2: fail-fast en matrix
En una matrix, fail-fast vale true por defecto. Cuando falla una celda, GitHub cancela las celdas que siguen ejecutándose, y estas informan "The operation was canceled" aunque estuvieran bien. El fallo real está en la celda en rojo, no en las canceladas.
strategy:
fail-fast: false
matrix:
node: [18, 20, 22]
Establezca fail-fast: false mientras depura para ver el resultado real de cada celda. Véase compilaciones con matrix.
Causa 3: timeouts
Un step o job que supera timeout-minutes se cancela. El máximo de un step es de 360 minutos, y los jobs en runners alojados por GitHub están limitados a 6 horas. A menudo un step se queda bloqueado esperando una entrada o un servicio de red. Lea comportamiento de timeout-minutes y límites de tiempo. Establezca límites explícitos para que los bloqueos fallen rápido:
jobs:
test:
timeout-minutes: 20
steps:
- run: npm test
timeout-minutes: 15
Causa 4: una persona o una API canceló la ejecución
Alguien hizo clic en Cancel workflow, o una automatización llamó a la API. Para comprobarlo:
gh run view RUN_ID --log | head -50
gh api repos/OWNER/REPO/actions/runs/RUN_ID --jq '.conclusion, .actor.login'
Son habituales las herramientas de publicación automatizada y el comando gh run cancel en otros workflows.
Causa 5: apagado o pérdida del runner
Los runners autoalojados en instancias spot, o los hosts de runner que se reinician, muestran The runner has received a shutdown signal y después cancelan los steps. Los runners alojados también pueden ser recuperados tras un incidente de infraestructura. Use runners efímeros con drenado controlado, o vuelva a los alojados por GitHub. Si el log indica que se perdió la comunicación, lea pérdida de comunicación con runners alojados.
Causa 6: un job dependiente falló
Un job con needs: se omite, no se cancela, cuando falla su dependencia. Si ve una cancelación, revise antes fail-fast o concurrency. Un step de limpieza con if: always() se ejecuta también al cancelar solo si usa if: always() o if: cancelled():
- name: Clean up
if: always()
run: ./cleanup.sh
Diagnóstico paso a paso
- Abra el resumen de la ejecución y lea las anotaciones. A menudo indican quién o qué la canceló.
- Revise el workflow en busca de
concurrency:. Si existe ycancel-in-progress: true, es probablemente la causa. - Compruebe si hay una matrix. Si alguna celda falló, corrija esa.
- Compare la duración del job con
timeout-minutes. - Si solo ocurre en runners autoalojados, revise los logs del host por reinicios.
Cómo prevenirlo
- Use grupos de concurrency por ref, nunca un único grupo global para todas las ramas.
- Desactive
cancel-in-progressen los workflows de despliegue y publicación. - Establezca
fail-fast: falseen las matrix cuyas celdas son independientes. - Añada
timeout-minutesa cada job y a los steps lentos. - Use
if: always()en la limpieza que debe ejecutarse siempre.
Las ejecuciones canceladas consumen minutos hasta el momento en que se detienen, por eso el enfoque con concurrency ahorra dinero; véase reducir la factura de GitHub Actions. También ayuda con las colas, véase Esperando a un runner. Si quiere jobs más cortos para que se cancelen con menos frecuencia, compiler.dev ejecuta los jobs existentes en máquinas de 8 vCPU / 16 GB con un cambio de una línea en runs-on.
Preguntas frecuentes
¿Cancela cancel-in-progress solo las ejecuciones más antiguas?
Sí. La ejecución más reciente de un grupo de concurrency continúa, y las ejecuciones en curso de ese mismo grupo se cancelan cuando cancel-in-progress: true.
¿Por qué las celdas de mi matrix que pasaban aparecen como canceladas?
fail-fast vale true por defecto. Una celda fallida cancela las demás que seguían ejecutándose.
¿Puedo saber quién canceló una ejecución?
Sí, en la anotación del resumen de la ejecución y mediante el campo de la API actor, además del registro de auditoría del repositorio.
¿Se factura una ejecución cancelada?
Solo paga los minutos utilizados antes de la cancelación.
Relacionado
- Cache Service Responded With 429: Cómo solucionarloSolucione "Failed to restore: Cache service responded with 429" en GitHub Actions: demasiadas solicitudes de caché. Actualice actions/cache y restaure y guarde una vez.
- fatal: could not read Username for github.com: SoluciónSolucione "fatal: could not read Username for 'https://github.com'" en GitHub Actions: repos privados, submódulos y dependencias git necesitan un token.
- Archivo de flujo de trabajo no válido: cómo solucionar el error de sintaxis YAMLCorrija "Invalid workflow file" y "You have an error in your yaml syntax" en GitHub Actions: sangría, valor inesperado, expresiones erróneas, con actionlint.
- JavaScript Heap Out of Memory en GitHub Actions: soluciónSolucione "FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory" y npm ENOMEM en GitHub Actions con NODE_OPTIONS.