本篇文章聊聊Node的進程退出，介紹各種可能導致 Node.js 進程退出的情況，希望對大家有所幫助！

在我們的服務發布后，難免會被運行環境（如容器、pm2 等）調度、升級服務導致重啟、各種異常導致進程崩潰；一般情況下，運行環境都有對服務進程的健康監測，在進程異常時，會重新拉起進程，在升級時，也有滾動升級的策略。但運行環境的調度策略是把我們服務的進程當成黑盒來處理的，不會管服務進程內部的運行情況，因此需要我們的服務進程主動感知運行環境的調度動作，然后做一些退出的清理動作。

因此我們今天就是梳理各種可能導致 Node.js 進程退出的情況，以及我們可以通過監聽這些進程退出事件做哪些事情。

原理

一個進程要退出，無非就是兩種情況，一是進程自己主動退出，另外就是收到系統信號，要求進程退出。

系統信號通知退出

在 Node.js 官方文檔 中列出了常見的系統信號，我們主要關注幾個：

• SIGHUP：不通過 ctrl+c 停止進程，而是直接關閉命令行終端，會觸發該信號
• SIGINT：按下 ctrl+c 停止進程時觸發；pm2 重啟或者停止子進程時，也會向子進程發送該信號
• SIGTERM：一般用于通知進程優雅退出，如 k8s 刪除 pod 時，就會向 pod 發送 SIGTERM 信號，pod 可以在超時時間內（默認 30s）做一些退出清理動作
• SIGBREAK：在 window 系統上，按下 ctrl+break 會觸發該信號
• SIGKILL：強制退出進程，進程無法做任何清理動作，執行命令 kill -9 pid，進程會收到該信號。k8s 刪除 pod 時，如果超過 30s，pod 還沒退出，k8s 會向 pod 發送 SIGKILL 信號，立即退出 pod 進程；pm2 在重啟或者停止進程時，如果超過 1.6s，進程還沒退出，也會發送 SIGKILL 信號

在收到非強制退出信號時，Node.js 進程可以監聽退出信號，做一些自定義的退出邏輯。比如我們寫了一個 cli 工具，需要比較長的時間執行任務，如果用戶在任務執行完成前想要通過 ctrl+c 退出進程時，可以提示用戶再等等：

const readline = require('readline');  process.on('SIGINT', () => {   // 我們通過 readline 來簡單地實現命令行里面的交互   const rl = readline.createInterface({     input: process.stdin,     output: process.stdout   });   rl.question('任務還沒執行完，確定要退出嗎？', answer => {     if (answer === 'yes') {       console.log('任務執行中斷，退出進程');       process.exit(0);     } else {       console.log('任務繼續執行...');     }     rl.close();   }); });    // 模擬一個需要執行 1 分鐘的任務 const longTimeTask = () => {   console.log('task start...');   setTimeout(() => {     console.log('task end');   }, 1000 * 60); };  longTimeTask();

實現效果如下，每次按下 ctrl + c 都會提示用戶：

進程主動退出

Node.js 進程主動退出，主要包含下面幾種情況：

• 代碼執行過程中觸發了未捕獲的錯誤，可以通過 process.on('uncaughtException') 監聽這種情況
• 代碼執行過程中觸發了未處理的 promise rejection（Node.js v16 開始會導致進程退出），可以通過 process.on('unhandledRejection') 監聽這種情況
• EventEmitter 觸發了未監聽的 error 事件
• 代碼中主動調用 process.exit 函數退出進程，可以通過 process.on('exit') 監聽
• Node.js 的事件隊列為空，可簡單認為沒有需要執行的代碼了，可以通過 process.on('exit') 監聽

我們知道 pm2 有守護進程的效果，在你的進程發生錯誤退出時，pm2 會重啟你的進程，我們也在 Node.js 的 cluster 模式下，實現一個守護子進程的效果（實際上 pm2 也是類似的邏輯）：

const cluster = require('cluster'); const http = require('http'); const numCPUs = require('os').cpus().length; const process = require('process');  // 主進程代碼 if (cluster.isMaster) {   console.log(`啟動主進程: ${process.pid}`);   // 根據 cpu 核數，創建工作進程   for (let i = 0; i < numCPUs; i++) {     cluster.fork();   }   // 監聽工作進程退出事件   cluster.on('exit', (worker, code, signal) => {     console.log(`工作進程 ${worker.process.pid} 退出，錯誤碼: ${code || signal}, 重啟中...`);     // 重啟子進程     cluster.fork();   }); }  // 工作進程代碼 if (cluster.isWorker) {   // 監聽未捕獲錯誤事件   process.on('uncaughtException', error => {     console.log(`工作進程 ${process.pid} 發生錯誤`, error);     process.emit('disconnect');     process.exit(1);   });   // 創建 web server   // 各個工作進程都會監聽端口 8000（Node.js 內部會做處理，不會導致端口沖突）   http.createServer((req, res) => {     res.writeHead(200);     res.end('hello worldn');   }).listen(8000);   console.log(`啟動工作進程: ${process.pid}`); }

應用實踐

上面分析了 Node.js 進程退出的各種情況，現在我們來做一個監聽進程退出的工具，在 Node.js 進程退出時，允許使用方執行自己的退出邏輯：

// exit-hook.js // 保存需要執行的退出任務 const tasks = []; // 添加退出任務 const addExitTask = fn => tasks.push(fn); const handleExit = (code, error) => {     // ...handleExit 的實現見下面 }; // 監聽各種退出事件 process.on('exit', code => handleExit(code)); // 按照 POSIX 的規范，我們用 128 + 信號編號 得到最終的退出碼 // 信號編號參考下面的圖片，大家可以在 linux 系統下執行 kill -l 查看所有的信號編號 process.on('SIGHUP', () => handleExit(128 + 1)); process.on('SIGINT', () => handleExit(128 + 2)); process.on('SIGTERM', () => handleExit(128 + 15)); // windows 下按下 ctrl+break 的退出信號 process.on('SIGBREAK', () => handleExit(128 + 21)); // 退出碼 1 代表未捕獲的錯誤導致進程退出 process.on('uncaughtException', error => handleExit(1, error)); process.on('unhandledRejection', error => handleExit(1, error));

信號編號：

接下來我們要實現真正的進程退出函數 handleExit，因為用戶傳入的任務函數可能是同步的，也可能是異步的；我們可以借助 process.nextTick 來保證用戶的同步代碼都已經執行完成，可以簡單理解 process.nextTick 會在每個事件循環階段的同步代碼執行完成后執行（理解 process.nextTick）；針對異步任務，我們需要用戶調用 callback 來告訴我們異步任務已經執行完成了:

// 標記是否正在退出，避免多次執行 let isExiting = false; const handleExit = (code, error) => {   if (isExiting) return;   isExiting = true;    // 標記已經執行了退出動作，避免多次調用   let hasDoExit = fasle;   const doExit = () => {       if (hasDoExit) return;       hasDoExit = true       process.nextTick(() => process.exit(code))   }    // 記錄有多少個異步任務   let asyncTaskCount = 0;   // 異步任務結束后，用戶需要調用的回調   let ayncTaskCallback = () => {       process.nextTick(() => {         asyncTaskCount--         if (asyncTaskCount === 0) doExit()        })   }   // 執行所有的退出任務    tasks.forEach(taskFn => {       // 如果 taskFn 函數的參數個數大于 1，認為傳遞了 callback 參數，是一個異步任務       if (taskFn.length > 1) {          asyncTaskCount++          taskFn(error, ayncTaskCallback)       } else {           taskFn(error)       }   });    // 如果存在異步任務   if (asyncTaskCount > 0) {       // 超過 10s 后，強制退出       setTimeout(() => {           doExit();       }, 10 * 1000)   } else {       doExit()   } };

至此，我們的進程退出監聽工具就完成了，完整的實現可以查看這個開源庫 async-exit-hook

https://github.com/darukjs/daruk-exit-hook

進程優雅退出

通常我們的 web server 在重啟、被運行容器調度（pm2 或者 docker 等）、出現異常導致進程退出時，我們希望執行退出動作，如完成已經連接到服務的請求響應、清理數據庫連接、打印錯誤日志、觸發告警等，做完退出動作后，再退出進程，我們可以使用剛才的進程退出監聽工具實現：

const http = require('http');  // 創建 web server const server = http.createServer((req, res) => {   res.writeHead(200);   res.end('hello worldn'); }).listen(8000);  // 使用我們在上面開發的工具添加進程退出任務 addExitTask((error, callback) => {    // 打印錯誤日志、觸發告警、釋放數據庫連接等    console.log('進程異常退出'， error)    // 停止接受新的請求    server.close((error) => {        if (error) {          console.log('停止接受新請求錯誤', error)        } else {          console.log('已停止接受新的請求')        }    })    // 比較簡單的做法是，等待一定的時間（這里我們等待 5s），讓存量請求執行完畢    // 如果要完全保證所有請求都處理完畢，需要記錄每一個連接，在所有連接都釋放后，才執行退出動作    // 可以參考開源庫 https://github.com/sebhildebrandt/http-graceful-shutdown    setTimout(callback, 5 * 1000) })

總結

通過上面的文字，相信你已經對導致 Node.js 進程退出的各種情況心里有數了。在服務上線后，雖然 k8s、pm2 等工具能夠在進程異常退出時，不停地拉起進程，保證服務的可用性，但我們也應該在代碼中主動感知進程的異常或者被調度的情況，從而能夠更早發現問題。