Node.jsで開発をしていると、誰もが一度は遭遇する「悪夢」があります。そう、`uncaughtException`（捕捉されない例外）によるプロセスの突然死です。
ある日突然、見知らぬバグでサーバが停止し、メモリ上のデータは消え去り、ユーザーからのリクエストは宙に浮く。そんな事態を防ぐための「セーフティネット」を構築することは、単なる守りではなく、エンジニアとしてのプロフェッショナリズムそのものです。
今日は、Node.jsというランタイムの挙動を深く理解し、アプリケーションを「壊れない」状態へと導くためのアーキテクチャについて、現場の知見を込めてお話しします。
—
なぜ、Node.jsの「例外ハンドリング」が難しいのか？
Node.jsのプロセスはシングルスレッドです。もし、どこか遠くのライブラリで捕捉しきれなかったエラーが発生すると、プロセスは「壊れた状態（Unstable State）」に陥ります。この状態で無理やり動かし続けるのは、「沈みかけた船の上でコーヒーを淹れる」ようなものです。
だからこそ、戦略はこうなります。
1. 致命的なエラーを検知する。
2. 溜まっている処理を安全に完遂する（Graceful Shutdown）。
3. プロセスを死なせ、クリーンな状態で再起動する（Supervisorの活用）。
—
【実装】クリーンなシャットダウンのためのセーフティネット
まずは、最小構成で「死に際を美しくする」コードを見てみましょう。
// server.js
const http = require(‘http’);
const server = http.createServer((req, res) => {
// ここで何か重い処理中にエラーが発生したと仮定
if (Math.random() > 0.5) throw new Error(‘想定外のクラッシュ！’);
res.end(‘Hello World’);
});
server.listen(3000, () => console.log(‘Server running on port 3000’));
/
- 致命的な例外が発生した際の最終防衛ライン
/
process.on(‘uncaughtException’, (err) => {
console.error(‘致命的なエラーを検知:’, err.message);
// 重要：ここでプロセスを即座に殺さず、シャットダウン処理へ移行する
gracefulShutdown();
});
function gracefulShutdown() {
console.log(‘シャットダウンを開始します…’);
// 新規接続の受付を停止
server.close(() => {
console.log(‘接続がクローズされました。プロセスを終了します。’);
process.exit(1); // 1 = エラー終了としてOSに通知
});
// タイムアウトを設定（いつまでも終わらない処理を強制終了するため）
setTimeout(() => {
console.error(‘タイムアウト：強制終了します’);
process.exit(1);
}, 10000);
}
このコードが教えてくれること
- `server.close()`: 新しいリクエストは拒否しつつ、現在処理中のリクエストが完了するのを待つという「優しさ」を実装しています。
- `setTimeout`: ゾンビプロセス（終われないプロセス）を放置しないための命綱です。
—
運用上の肝：プロセス管理ツール（Supervisor）の導入
プログラム側でどれだけ対策しても、プログラムが死ぬ以上、「誰が起こすか」という視点が不可欠です。本番環境では `pm2` や `systemd`、あるいはコンテナなら `Kubernetes` がその役割を担います。
ここでは、最も手軽で強力な `pm2` を紹介します。
1. PM2の導入
PM2をグローバルにインストール
npm install -g pm2
アプリを起動し、異常終了時に自動再起動させる
pm2 start server.js –name “my-app” –watch
2. なぜPM2が必要なのか
PM2は、OSのプロセス管理を抽象化し、以下の利益をもたらします。
- 自動再起動: プロセスが異常終了しても、即座に新しいプロセスを立ち上げます。
- ログ管理: 死に際のスタックトレースを別ファイルに確実に保存してくれます。
- ゼロダウンタイム・リロード: コード修正時に止めることなく差し替えが可能です。
—
初心者が陥る「やってはいけない」罠
多くの初心者が、「`process.on(‘uncaughtException’)` を使えばプロセスを維持できる」と勘違いします。しかし、これは間違いです。
例外をキャッチして `return` しても、メモリの中身が整合性を失っている可能性があるからです。 プロセスを維持しようとせず、「死んで、新しく生まれる」のがNode.jsにおける最も安全な設計思想です。この考え方を「イミュータブルなプロセス管理」と呼びます。
—
まとめ：今日からできるステップ
1. エラーを隠さない: `uncaughtException` で無理やり動かし続けない。ログを出して終了する。
2. Graceful Shutdownを実装する: 現在の接続を安全に終了させる。
3. プロセス管理ツールを使う: 死んだら自動で生き返る環境を作る。
この3点をマスターするだけで、あなたのNode.jsアプリケーションは、「たまに死ぬ不安定なプログラム」から、「異常を検知し、自ら回復するプロフェッショナルなシステム」へと進化します。
「動いたからOK」ではなく、「どう死ぬか」を設計する。これこそが、アーキテクトへの第一歩です。さあ、まずはあなたのコードに `process.on(‘uncaughtException’, …)` を書き足すところから始めてみてください。世界が少しだけ、堅牢に見えるはずですよ。