DIV CSS 佈局教程網

Node.js 回應超時 timeout 機制詳解
編輯:關於JavaScript     

如果伺服器在指定時間內沒有完成回應——可能是網路連線不穩、伺服器故障,也可能是防火牆攔掉了連線——就會發生「回應超時」。Node.js 的 http.ServerResponse 對應地會觸發 timeout 事件。

API 用法

response.setTimeout(time, [callback]);

有兩種寫法:直接把回呼函數當第二個參數傳入,或者只設定時間、另外用事件監聽的方式處理。

res.setTimeout(1000);
res.on("timeout", function () {
  console.log("響應超時.");
});

有沒有回呼函數,行為完全不同

這是最容易踩坑的地方:

  • 沒有指定超時回呼函數:一旦超時,Node 會自動關閉與該客戶端之間的 socket 連線。
  • 有指定超時回呼函數:超時時只會呼叫你的回呼函數,socket 不會被自動關閉,連線是否結束由你自己決定。

也就是說,寫了回呼卻忘了 res.end() 或 socket.destroy(),連線就會一直掛著。

完整範例

var http = require("http");
var server = http.createServer(function (req, res) {
  if (req.url !== "/favicon.ico") {
    // 寫法一:超時監聽
    // res.setTimeout(1000);
    // res.on("timeout", function () {
    //   console.log("響應超時.");
    // });

    // 寫法二:超時直接回呼
    res.setTimeout(1000, function () {
      console.log("響應超時.");
    });

    // 故意延遲 2 秒才回應,超過 1 秒的超時設定
    setTimeout(function () {
      res.setHeader("Content-Type", "text/html");
      res.write("<html><head><meta charset='utf-8' /></head>");
      res.write("你好");
      res.end();
    }, 2000);
  }
});
server.listen(1337, "localhost", function () {
  console.log("開始監聽" + server.address().port + "......");
});

執行結果(帶回呼函數):

移掉超時回呼函數之後:

兩張圖的差異正好印證了上面的規則:少了回呼,連線被直接切斷;有了回呼,程式取得主導權,可以選擇補送錯誤頁、記錄日誌或做重試。

實務建議

生產環境中,回呼裡通常要搭配 res.statusCode = 504 這類狀態碼與一段友善的提示內容,並記得結束回應;若是長連線或串流回應,也要評估是否該停用超時設定。此外,Node 她被動等待的還有所需時間,setTimeout 只涵蓋「回應階段」,連線建立階段建議另用 server.setTimeout 或 requestTimeout 等設定一併把關。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved