2023-04-29|閱讀時間 ‧ 約 6 分鐘

【程式語言 - NodeJS】如何從Nodejs程序退出

一般來說我們如果將程式運行在console上,只要用ctrl + c 之類的強制中斷方式就能讓程式中止,但如果我們想要在程式運行到一半時,偵測到某些例外狀況就離開程式,可以怎麼做呢?
nodejs核心模組提供了process.exit()的方法可以讓程式強制中止,但使用了這個功能之後,我們尚未完成的callback、尚未回應的request、甚至尚未寫到stderr、stdout 過程,都會被強制中斷,這樣並非是一個完美的退出方式,因此我們會介紹在nodejs環境下怎麼優雅的退出程式。
先來談談process.exit(number)這個方法,其實參數是可以帶入一個整數值的,預設為0,代表正常的退出程式,常見的Exit Code代表意義如下:
  • 1 Uncaught Fatal Exception:代表未被捕捉到的例外,並且未被domain或uncaughtExceptio event handler 處理到的例外狀況。
  • 2 : 未被使用, Bash為了防止內部濫用而保留。
  • 3 Internal JavaScript Parse Error : Nodejs內部的Javascript語法解析錯誤,只有在開發Nodejs本身的時候出現。
  • 4 Internal JavaScript Evaluation Failure :Nodejs內部的返回函數值失敗,只有在開發Nodejs本身的時候出現。
  • 5 Fatal Error :在V8引擎的錯誤,一般來說會以FATALERROR輸出到stderr。
  • 6 Non-function Internal Exception Handler:發生一個內部異常,但異常處理函數被設置成非函數或者不能被調用。
  • 7 Internal Exception Handler Run-Time Failure:不能捕捉的異常,在處理這個異常的時候,函數本身拋出一個錯誤,例如:uncaughtException。
  • 9 Invalid Argument:未填上必要的參數。
  • 10 Internal JavaScript Run-Time Failure: 一般來說只有在開發Nodejs本身會出現,這是在運行Nodejs內部Javascript所拋出的錯誤。
  • 12 Invalid Debug Argument: --inspect選項已經配置,但選擇的port無效或不可用。
  • 13 Unfinished Top-Level Awai。
  • 128 Signal Exits:如果Nodejs收到SIGKILL、SIGHUP,那麼退出代碼就會是128加上訊號的value值,例如SIGKILL的value為9,那麼錯誤碼就會是128+9 = 137 ,請參考這裡: https://man7.org/linux/man-pages/man7/signal.7.html
我們也可以設定process.exitCode的屬性值:
process.exitCode = 1
這種方式不會讓我們直接離開,而是當程式執行完畢在離開時指定返回的離開代碼。
但很多時候,我們會啟動一個http server常駐於背景,監聽http request並處理回應,如下:
const express = require('express')
const app = express()app.get('/', (req, res) => {
 res.send('Hi!')
})app.listen(3000, () => console.log('Server ready'))
我們可以看到上述的程式並不會執行完成就離開程式,假設我們使用了process.exit()時,任何當前待處理或正在處理的請求都將被強制中斷,這並非是一個好方法。
在這種情況之下,我們需要發送一個中斷的訊號,而且要掛一個handler來處理這個訊號:
const express = require('express')const app = express()app.get('/', (req, res) => {
 res.send('Hi!')
})const server = app.listen(3000, () => console.log('Server ready'))process.on('SIGTERM', () => {
 server.close(() => {
   console.log('Process terminated')
 })
})
  • SIGKILL: 代表程式強制中止的訊號,就如直接呼叫process.exit()。
  • SIGTERM: 這個訊號代表訊號較安全的中止方式,會由upstart 或 supervisord ...等遠程管理者發出。
我們可以從程式內部發送此訊號:
process.kill(process.pid, 'SIGTERM')
分享至
成為作者繼續創作的動力吧!
主軸圍繞於軟體科技, 除了過往經驗成章以外也持續學習新技能, 並將學習心法記錄與分享, 以期幫助相同道路之夥伴。 裡面包含著各種程式語言的疑難雜症解題技巧, 也提供資料庫、AI、認證與授權、工具庫...等技巧, 讓您自由找出您想要的解答, 如果您想要系統化的教學課程也歡迎至「🔒 阿Han的軟體心法實戰營」。
© 2024 vocus All rights reserved.