Runner perdió la comunicación con el servidor: solución
Última actualización · Publicado por primera vez
El error The hosted runner lost communication with the server significa que el proceso del runner de GitHub dejó de comunicarse con GitHub mientras se ejecutaba su job. En la práctica, casi siempre se debe a que la VM del runner se queda sin memoria, CPU o disco, o a que un paso mató o bloqueó el propio runner. Esta página ordena las causas y muestra cómo identificar cuál le afectó. Si nada de lo siguiente encaja y fallan muchos jobs no relacionados a la vez, consulte la página de estado de GitHub.
El mensaje exacto
The hosted runner: GitHub Actions 12 lost communication with the server. Anything in your
workflow that terminates the runner process, starves it for CPU/Memory,
or blocks its network access can cause this error.
El mensaje en sí enumera las causas habituales. No puede conectarse por SSH a un runner alojado que ya ha terminado, así que el diagnóstico se hace a partir de los logs y del uso de recursos. Para conocer los límites de cada máquina, consulte la referencia de runners alojados en GitHub: los runners Linux estándar para repositorios privados tienen 2 CPU y 8 GB de RAM, según la revisión de octubre de 2026.
Causas, de la más probable a la menos probable
1. Memoria insuficiente
Un proceso de compilación o de pruebas consume toda la RAM, el sistema entra en thrashing y el agente del runner deja de responder. A veces aparece el código de salida 137 en lugar de este mensaje, y otras veces solo aparece este mensaje. Los desencadenantes típicos son las compilaciones de webpack o Next.js, Jest con muchos workers, Gradle o Maven con heaps grandes y las builds de Docker que compilan proyectos extensos.
Registre el uso de memoria para confirmarlo:
- name: Watch memory
run: |
(while true; do date +%T; free -m | sed -n 2p; sleep 10; done) &
- run: npm run build
Si la memoria se acerca al total antes del fallo, reduzca el paralelismo:
- run: npx jest --maxWorkers=2
env:
NODE_OPTIONS: --max-old-space-size=4096
2. Disco lleno
Un disco lleno puede bloquear herramientas y romper el registro propio del runner. Compruebe el espacio con df -h y busque No space left on device.
3. Falta de CPU
Un bucle infinito, una prueba que crea procesos hijos sin límite o demasiados compiladores en paralelo pueden dejar al agente del runner sin tiempo de CPU. Limite el paralelismo (make -j2, --workers, GOMAXPROCS) y ejecute el paso más pesado con nice.
4. Un paso que mata o modifica el runner
Los scripts que ejecutan pkill, killall node, sudo shutdown, detienen Docker o servicios del sistema, o activan un firewall pueden cortar la conexión del runner. Mate procesos por patrón o PID concreto, y nunca toque los procesos Runner.Listener ni Runner.Worker.
- run: pkill -f "my-test-server" # specific, not 'node'
5. Cambios de red dentro del job
Los pasos de VPN, las reglas de iptables y las ediciones de /etc/hosts pueden bloquear la conexión saliente del runner hacia GitHub. Si debe hacerlos, permita los endpoints de GitHub; los rangos de IP están en la API meta.
6. Runners autoalojados e instancias spot
En runners autoalojados o con autoescalado, la VM puede ser expulsada, reiniciada por una actualización o perder la red. Use runners efímeros, asegúrese de que el host nunca entre en suspensión y lea los logs _diag del runner para ver el motivo real. El mensaje es el mismo, pero la solución está en su infraestructura.
7. Un incidente de GitHub
Si fallan a la vez muchos workflows no relacionados, puede deberse a GitHub. Vuelva a ejecutarlos cuando termine el incidente.
Cómo diagnosticarlo
- Abra la ejecución fallida y anote el paso que se estaba ejecutando cuando se cortó. Ese paso es el principal sospechoso.
- Active el registro de depuración definiendo el secreto o la variable
ACTIONS_STEP_DEBUGcon el valortrue. Consulte habilitar el registro de depuración. - Añada el registro de memoria y disco descrito arriba y vuelva a ejecutar.
- Pruebe el mismo job con un paralelismo menor. Si pasa, la causa es la presión sobre los recursos.
Soluciones según el resultado
- La memoria es el problema y ajustarla no basta: use una máquina con más RAM. Funciona un runner grande de GitHub, así como un proveedor como compiler.dev, cuya máquina Linux predeterminada tiene 8 vCPU / 16 GB con una VM nueva para cada job. Consulte precios.
- Un paso concreto mata el runner: cámbielo para que solo afecte a sus propios procesos.
- Intermitente y sin causa clara: vuelva a ejecutar y, si se repite, contacte con el Soporte de GitHub indicando la URL de la ejecución.
Un wrapper de reintentos es un parche provisional para un paso inestable, no una solución:
- uses: nick-fields/retry@v3
with:
timeout_minutes: 15
max_attempts: 2
command: npm test
Cómo prevenirlo
- Defina límites de memoria en las herramientas (
NODE_OPTIONS,-Xmx,GRADLE_OPTS). - Limite los workers en paralelo al número de CPU del runner.
- Divida las compilaciones grandes en jobs separados en lugar de un único job muy largo (consulte los límites de tiempo y timeout-minutes).
- Registre memoria y disco para ver las tendencias antes de un fallo.
- Nunca ejecute comandos
pkillgenerales.
Preguntas frecuentes
¿Es "lost communication with the server" una caída de GitHub?
A veces, pero normalmente su job agotó la memoria, el disco o la CPU. Si fallan otros repositorios al mismo tiempo, consulte la página de estado.
¿Por qué ocurre solo en algunas ejecuciones?
El uso de memoria y disco varía según el orden de las pruebas, el estado de la caché y el tamaño de las entradas. Un job cerca del límite falla de forma intermitente.
¿Pago por la ejecución fallida?
Los minutos consumidos hasta el fallo se facturan como cualquier otro. Consulte la tarifa de GitHub Actions.
¿Es lo mismo que el código de salida 137?
Comparten causas, sobre todo la falta de memoria, pero se diferencian en lo que usted ve. El código de salida 137 indica que se terminó un proceso. La pérdida de comunicación indica que todo el runner dejó de responder.
Relacionado
- Runners autohospedados vs. GitHub-hosted: coste y riesgoCompare runners alojados en GitHub, autohospedados y de terceros en coste, velocidad, seguridad y mantenimiento, con fórmula de punto de equilibrio.
- ¿Qué es un runner autoalojado? (GitHub Actions)Un runner autohospedado es una máquina bajo su control que ejecuta jobs de GitHub Actions. Vea cómo funciona, sus riesgos de seguridad y cuándo compensa.
- 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.