如果伺服器在指定時間內沒有完成回應——可能是網路連線不穩、伺服器故障,也可能是防火牆攔掉了連線——就會發生「回應超時」。Node.js 的 http.ServerResponse 對應地會觸發 timeout 事件。
response.setTimeout(time, [callback]);
有兩種寫法:直接把回呼函數當第二個參數傳入,或者只設定時間、另外用事件監聽的方式處理。
res.setTimeout(1000);
res.on("timeout", function () {
console.log("響應超時.");
});
這是最容易踩坑的地方:
也就是說,寫了回呼卻忘了 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 等設定一併把關。