Problemas GitHub: qué hacer cuando la plataforma no funciona
Si has llegado hasta aquí es porque algo en GitHub no responde como debería. Puede que no consigas hacer push a tu repositorio, que la web se quede cargando indefinidamente o que las Actions se hayan quedado colgadas a medias. Antes de darle vueltas a tu configuración, merece la pena comprobar si se trata de una incidencia general o de algo puntual en tu cuenta.
En esta página encontrarás una guía práctica para identificar el origen del problema, soluciones que puedes aplicar por tu cuenta y cuándo tiene sentido contactar con soporte. Arriba puedes consultar los avisos de avería reportados por otros usuarios en tiempo real.
¿Avería general o problema local?
Lo primero es descartar lo obvio. GitHub es un servicio con millones de usuarios activos cada día y, aunque su infraestructura es robusta, no está exenta de cortes puntuales que afectan a repositorios, Actions, Pages o el propio inicio de sesión.
Si varios servicios fallan a la vez (por ejemplo, no puedes hacer login y tampoco cargan los issues), es más probable que sea una incidencia general. Si solo tú tienes problemas mientras otros compañeros de equipo trabajan sin incidencias, el fallo suele estar en tu extremo: conexión, configuración local o el propio navegador.
Señales de que el problema es tuyo
- Tus compañeros de equipo acceden a GitHub sin problemas en este momento.
- El fallo solo ocurre en un dispositivo o navegador concreto.
- Otras webs y servicios online funcionan con normalidad.
- El error desaparece al probar en modo incógnito o desde otra red.
Qué puedes probar tú mismo antes de nada
Antes de escalar el problema, hay varias comprobaciones rápidas que resuelven la mayoría de los casos de «GitHub no funciona» que reportan los usuarios en España.
- Comprueba tu conexión a internet abriendo otra web distinta.
- Recarga la página forzando la caché con Ctrl+F5 (o Cmd+Shift+R en Mac).
- Prueba a acceder desde una ventana de incógnito para descartar extensiones o cookies conflictivas.
- Verifica que tu sesión no ha caducado y vuelve a iniciar sesión.
- Si usas Git por línea de comandos, comprueba tu conexión SSH con
ssh -T [email protected]. - Revisa que tu token de acceso personal no haya expirado, sobre todo si usas autenticación por token en lugar de contraseña.
- Actualiza tu navegador o cliente de Git a la última versión disponible.
Un simple cierre de sesión y reinicio del navegador soluciona buena parte de los errores de carga o de autenticación reportados por usuarios particulares.
Averías y fallos frecuentes en GitHub
Estas son algunas de las incidencias que los usuarios suelen encontrar con más frecuencia, junto con la solución habitual que puedes intentar por tu cuenta.
| Problema habitual | Posible causa | Qué puedes hacer |
|---|---|---|
| No se puede hacer push o pull | Problema de red, credenciales caducadas o repositorio bloqueado | Comprueba tu conexión, renueva el token o la clave SSH y verifica permisos del repositorio |
| La web carga muy lento o no carga | Congestión temporal del servicio o problema local de caché | Recarga forzando caché, prueba en incógnito o cambia de red |
| GitHub Actions no se ejecuta | Cola de ejecución saturada o error en el workflow | Revisa el archivo YAML del workflow y consulta el estado de las Actions en tu repositorio |
| No llega el correo de verificación | Filtro de spam o retraso en el envío | Revisa la carpeta de spam y solicita el reenvío pasados unos minutos |
| Error al iniciar sesión con 2FA | Desincronización horaria de la app de autenticación | Sincroniza la hora del dispositivo o usa un código de recuperación |
Códigos de error comunes y su significado
Al trabajar con Git desde la terminal es habitual encontrarse con mensajes de error concretos. Estos son algunos de los más frecuentes.
| Código o mensaje | Significado | Solución recomendada |
|---|---|---|
| 403 Forbidden | No tienes permisos suficientes o el token no es válido | Genera un nuevo token de acceso personal y actualiza tus credenciales guardadas |
| 404 Not Found | El repositorio no existe o no tienes acceso a él | Verifica la URL del repositorio y confirma que tienes permisos de acceso |
| Permission denied (publickey) | La clave SSH no está configurada correctamente | Comprueba que tu clave pública está añadida a tu cuenta de GitHub |
| 500 Internal Server Error | Error temporal en los servidores de GitHub | Espera unos minutos y vuelve a intentarlo |
Cuándo contactar con el servicio de atención al cliente
Si has revisado los puntos anteriores y el problema persiste, o si sospechas que se trata de una incidencia más amplia que afecta a tu cuenta de pago (GitHub Team, Enterprise o Copilot), lo mejor es acudir directamente al soporte oficial.
Puedes consultar el estado del servicio y contactar con el equipo de soporte a través de la web oficial de soporte de GitHub. Allí también encontrarás documentación técnica detallada para resolver incidencias más específicas de tu cuenta o repositorio.
Antes de escribir a soporte, ten a mano:
- El nombre de usuario o de la organización afectada.
- El repositorio concreto donde ocurre el problema, si aplica.
- Una captura de pantalla del error o del mensaje exacto.
- La hora aproximada en la que empezó la incidencia.
Cuando GitHub no funciona, en la mayoría de los casos se trata de un contratiempo pasajero que se resuelve en minutos, ya sea por tu parte o porque el servicio se restablece por sí solo. Comprobar antes si es un fallo general te ahorra tiempo y te permite centrarte en tu trabajo cuanto antes.
Vuelve a esta página siempre que detectes una incidencia: aquí encontrarás los avisos más recientes reportados por otros usuarios y podrás confirmar rápidamente si el problema es generalizado o solo tuyo.
