Saltar al contenido principal

Solución de Problemas

Esta sección proporciona soluciones a problemas comunes que puedes encontrar al usar la plataforma STATUS.

Problemas Comunes​

Problemas de Instalación​

Problema: Las dependencias no se instalan correctamente​

Solución:

# Limpiar la caché de npm y reinstalar
npm cache clean --force
rm -rf node_modules package-lock.json
npm install

Problema: El puerto ya está en uso​

Solución:

# Encontrar y eliminar el proceso que usa el puerto
lsof -ti:3000 | xargs kill -9

Problemas de Ejecución​

Problema: El servicio no arranca​

Solución:

  • Verifica que todas las variables de entorno requeridas estén configuradas
  • Verifica que todas las dependencias estén instaladas
  • Revisa los logs para mensajes de error específicos

Problema: Errores de conexión​

Solución:

  • Verifica la conectividad de red
  • Comprueba la configuración del firewall
  • Asegúrate de que los servicios se ejecutan en los puertos correctos

Problemas de Configuración​

Problema: Las variables de entorno no se cargan​

Solución:

  • Verifica que el archivo .env existe y está formateado correctamente
  • Asegúrate de que las variables de entorno se exportan correctamente
  • Reinicia el servicio después de realizar cambios

Obtener Ayuda​

Si encuentras un problema que no está cubierto aquí:

  1. Revisa los Issues de GitHub para problemas similares
  2. Revisa la documentación exhaustivamente
  3. Contacta con la comunidad para obtener soporte
  4. Crea un nuevo issue con información detallada sobre tu problema

Logs y Depuración​

Habilita el registro de depuración para obtener más información sobre los problemas:

# Activar modo de depuración
export DEBUG=status:*

Revisa los logs en la ubicación apropiada para tu implementación.