Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Add Graceful Shutdown example to fix Nodemon hanging on restarts (EADDRINUSE)

Abierto Apto para principiantes
  • ¿Algo no está bien?
#2,226 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
65/100
Tipo de issue
Documentación
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
express, node.js, typescript
Área
documentation

Línea de trabajo

No se especifica ningún archivo de destino ni ninguna prueba; comienza localizando la documentación oficial de configuración de Express/Turso. Añade el ejemplo proporcionado de graceful shutdown y verifica que explique cómo gestionar SIGINT, SIGTERM y SIGUSR2 y cómo cerrar la conexión de @libsql/client para que Nodemon pueda reiniciarse sin EADDRINUSE.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Hello! I am a beginner using Turso with Express and Nodemon, and I recently ran into a very frustrating issue that took me a while to figure out.

I'm opening this issue as a documentation request because I think adding a small note about this could save other developers a lot of time!

The Problem I Faced 🐛

Whenever I saved a file, nodemon would attempt to restart my Express server, but it would fail or my new routes wouldn't show up. I was getting errors like:

  • Cannot GET /my-new-route (the server was stuck on the old code)
  • EADDRINUSE: address already in use :::3000

It turns out that @libsql/client holds an active, persistent socket connection. When nodemon sends the restart signal (SIGUSR2), Node.js refuses to exit because the database connection is still keeping the event loop alive. This leaves the old server running as a "zombie" process holding port 3000.

The Solution 🛠️

I finally figured out that I needed to explicitly call tursoClient.close() inside a graceful shutdown handler so nodemon could clean up and restart properly.

Since this is such a common trap when setting up local development, could we add a small snippet about 'Graceful Shutdowns' to the official documentation?

Here is the solution code that worked perfectly for me, which might be helpful to add to the docs:

import express from "express";
import { createClient } from "@libsql/client";

const app = express();
const PORT = process.env.PORT || 3000;

export const tursoClient = createClient({
    url: process.env.TURSO_DATABASE_URL!,
    authToken: process.env.TURSO_AUTH_TOKEN!,
});

const server = app.listen(PORT, () => {
    console.log(`Server is running on port ${PORT}`);
});

// Graceful shutdown — close turso connection so nodemon can restart cleanly
const shutdown = async () => {
    console.log("Shutting down gracefully...");
    tursoClient.close();
    server.close(() => {
        process.exit(0);
    });
};

// Handle Ctrl+C
process.on("SIGINT", shutdown);
// Handle Docker/System shutdown
process.on("SIGTERM", shutdown);
// Handle Nodemon restarts
process.once("SIGUSR2", async () => {
    await shutdown();
});

Thank you for the amazing database!

Lenguaje dominante
C
Estrellas
17.3k
Forks
545
Sin PR fusionados en 30 d

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de tursodatabase/libsql

Todos los issues de tursodatabase/libsql

Issues similares

Más issues de C

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.