Saltar al contenido principal

Troubleshooting

Guía para resolver problemas comunes en Floutic.

Problemas Comunes​

Los servicios no inician​

Síntomas:

  • Los contenedores no se levantan
  • Errores al ejecutar docker compose up

Soluciones:

  1. Verifica que Docker esté ejecutándose
  2. Revisa los logs: docker compose logs
  3. Asegúrate de que los puertos no estén en uso
  4. Verifica las variables de entorno en .env

Error de conexión a la base de datos​

Síntomas:

  • Backend no puede conectarse a PostgreSQL
  • Errores de conexión en los logs

Soluciones:

  1. Verifica que PostgreSQL esté saludable: docker compose ps postgres
  2. Revisa las variables de entorno DATABASE_URL
  3. Verifica que el volumen de PostgreSQL esté montado correctamente
  4. Revisa los logs: docker compose logs postgres

Frontend no carga​

Síntomas:

Soluciones:

  1. Verifica que el backend esté saludable primero
  2. Revisa los logs del frontend: docker compose logs frontend
  3. Verifica que las variables de entorno estén configuradas
  4. Limpia el caché: docker compose exec frontend npm run clear

Documentación no se construye​

Síntomas:

  • Errores al construir Docusaurus
  • El sitio no se sirve correctamente

Soluciones:

  1. Verifica que Node.js 20+ esté disponible
  2. Limpia el caché: docker compose exec docs npm run clear
  3. Reconstruye: docker compose exec docs npm run build
  4. Revisa los logs: docker compose logs docs

Comandos Útiles​

# Ver estado de todos los servicios
docker compose ps

# Ver logs de un servicio específico
docker compose logs -f backend

# Reiniciar un servicio
docker compose restart backend

# Reconstruir un servicio
docker compose up -d --build backend

# Limpiar todo y empezar de nuevo
docker compose down -v
docker compose up -d

Obtener Ayuda​

Si no puedes resolver el problema:

  1. Revisa los logs completos
  2. Consulta la documentación específica del componente
  3. Abre un issue en GitHub con los logs y detalles del problema