Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

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

オープン 初心者向け
  • 何か問題がありますか？
#2,226 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
65/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
静か
技術スタック
express, node.js, typescript
領域
documentation

調査の方向性

対象ファイルもテストも指定されていないため、まず Express/Turso の公式セットアップドキュメントを見つけてください。提供された graceful-shutdown の例を追加し、SIGINT、SIGTERM、SIGUSR2 の処理と @libsql/client 接続のクローズについて説明していることを確認してください。これにより、Nodemon が EADDRINUSE なしで再起動できるようにします。

索引モデルが issue の本文から書いたものです。

説明

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!

主要言語
C
スター
17.3k
フォーク
550
30日以内にマージされた PR はありません

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

tursodatabase/libsql のほかの issue

tursodatabase/libsql の issue をすべて見る

似ている issue

C の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。