Problemas comunes

Mi servidor se quedó congelado

El servidor aparece En línea pero tu bot no responde, la consola no avanza o se quedó en Deteniendo.

2 min de lectura

Un servidor «congelado» sigue encendido pero no hace nada útil: el bot no contesta, la consola no muestra nada nuevo o el botón Detener no surte efecto.

Se quedó en «Deteniendo»

Los botones de energía están arriba, en la barra lateral del panel de control:

Botones de energía del panel de control: Iniciar en verde, Reiniciar en gris y Detener en rojo

Detener le envía a tu aplicación la misma señal que Ctrl + C en una terminal y espera a que se cierre por sí sola. Si tu código no termina (por ejemplo, porque hay una conexión o un temporizador que lo mantiene vivo), el servidor se queda en Deteniendo.

En ese caso, vuelve a hacer clic en el botón rojo Detener. Mientras el servidor está en Deteniendo, el panel de control te ofrece forzar la detención:

Diálogo Forzar detención del proceso, con la advertencia de que puede provocar corrupción de datos y el botón Continuar marcado

Continuar cierra el proceso al instante. Lo que tu aplicación no haya guardado en ese momento se pierde, así que úsalo solo cuando Detener no funcionó.

Para que Detener funcione siempre, cierra tus conexiones al recibir la señal:

process.on('SIGINT', async () => {
  await client.destroy(); // cierra el bot de Discord, la base de datos, etc.
  process.exit(0);
});

Está «En línea» pero el bot no responde

Mira el uso de CPU y memoria en la Consola:

CPU al 100 % todo el tiempo. Tu código está atrapado en un bucle (while (true), una función que se llama a sí misma sin fin) o haciendo un trabajo muy pesado de forma síncrona. Mientras eso ocurre, Node.js no puede atender nada más. Reinicia el servidor y busca ese bucle en la parte del código que se ejecutó justo antes.
Memoria casi al límite. Antes de mostrar el error de memoria, Node.js puede pasar varios minutos intentando liberar espacio, y durante ese tiempo no responde. Si después aparece JavaScript heap out of memory, la causa es la memoria: revisa Mi bot se apaga o se reinicia solo.
CPU y memoria normales. El proceso está esperando algo que no llega: una base de datos que no responde, una API externa caída o una promesa que nunca se resuelve. Revisa que tus servicios externos estén funcionando y agrega tiempos de espera (timeouts) a tus peticiones.

La consola no muestra nada nuevo

Si la consola se quedó quieta pero el servidor responde, recarga la página del panel de control: la consola se vuelve a conectar. Si después de recargar sigue sin mostrar nada y el bot no responde, reinicia el servidor.