HTTP 是通用協議,不綁定任何特定語言,各家語言的實現細節不同但思想一致。NodeJS 作為宿主運行環境,以 JavaScript 為宿主語言,自然也有一套自己的實現。動手之前,建議先掃一遍官方 API 文檔建立前置概念,會省下不少摸索的功夫。
建立 server.js:
var http = require('http');
var server = http.createServer(function (req, res) {
res.writeHeader(200, {
'Content-Type': 'text/plain;charset=utf-8' // 別忘了 charset
});
res.end("Hello, 大熊!");
});
server.listen(8888);
console.log("http server running on port 8888 ...");
執行 node server.js,成果如下:

第一行透過 require 引入 Node 自帶的 http 模塊並賦值給變數。
第二行呼叫 http.createServer,它會回傳一個新的 web 伺服器物件。參數 requestListener 是一個函式,會被自動加入 request 事件的監聽隊列。每當有請求到來,事件迴圈就把這個監聽器放進執行隊列——Node 中所有的代碼都是一個一個從執行隊列裡拿出來執行的,且都在同一個工作線程上運行,這也是我們常說 Node 是單線程執行環境的由來。
再看這個回調函式,它收到兩個參數:request 與 response。要留意的是每個連接可能包含多個請求(keep-alive 連接就是如此)。request 是 http.IncomingMessage 的實例,response 是 http.ServerResponse 的實例。
這裡有個必須記牢的結論:http request 對象是可讀流,http response 對象則是可寫流。 IncomingMessage 由 http.Server 或 http.ClientRequest 創建,分別傳給 request 與 response 事件,除了標準的 Stream 接口之外,還提供了一些額外的事件、方法與屬性用來讀取狀態、標頭與資料。
writeHeader 這一步用 response.writeHead() 送出狀態碼 200 與 Content-Type 標頭。其中 statusCode 是三位的 HTTP 狀態碼,最後一個參數 headers 則是響應標頭的內容:
var body = 'hello world';
response.writeHead(200, {
'Content-Length': body.length,
'Content-Type': 'text/plain'
});
注意:Content-Length 是按位元組計算,而不是按字符計算。上面的例子之所以沒問題,是因為字串剛好只包含單位元組字符。若 body 含多位元組字符(例如中文),就該改用 Buffer.byteLength() 來取得實際位元組數。另外要提醒的是,Node 並不會主動檢查 Content-Length 與實際傳輸的 body 長度是否吻合,這件事得由開發者自己負責。
至於狀態碼的說明,http.STATUS_CODES 收錄了所有標準 HTTP 響應狀態碼及其簡短描述,源碼节选如下(節錄自 Nodejs 源碼 http.js):
var STATUS_CODES = exports.STATUS_CODES = {
100 : 'Continue',
101 : 'Switching Protocols',
200 : 'OK',
201 : 'Created',
204 : 'No Content',
206 : 'Partial Content',
301 : 'Moved Permanently',
302 : 'Moved Temporarily',
304 : 'Not Modified',
400 : 'Bad Request',
401 : 'Unauthorized',
403 : 'Forbidden',
404 : 'Not Found',
405 : 'Method Not Allowed',
408 : 'Request Time-out',
418 : 'I\'m a teapot', // RFC 2324
500 : 'Internal Server Error',
502 : 'Bad Gateway',
503 : 'Service Unavailable',
504 : 'Gateway Time-out'
// ……其餘狀態碼同樣定義在此物件中
};
從客戶端的響應結果也能印證這一點:

response.end 的作用是:當所有響應標頭與報文都送出後,向伺服器發出完成信號。每次響應結束都必須呼叫它;若呼叫時帶了 data 參數,效果等同於先執行 response.write(data, encoding) 再執行 response.end()。
server.listen(8888) 則讓伺服器在指定埠上接受連接。
除了用 request 物件讀取請求標頭,還能把它當作一個只讀數據流來讀取請求體:
http.createServer(function (request, response) {
var body = [];
console.log(request.method);
console.log(request.headers);
request.on('data', function (chunk) {
body.push(chunk);
});
request.on('end', function () {
body = Buffer.concat(body);
console.log(body.toString());
});
}).listen(8888);
這裡的關鍵是先把每個 chunk 推入陣列,等 end 事件觸發後再用 Buffer.concat 合併,避免直接做字串拼接時可能出現的多位元組字符被截斷問題。
對應的完整 HTTP 請求內容大致如下:
POST / HTTP/1.1 User-Agent: curl/7.26.0 Host: localhost Accept: */* Content-Length: 11 Content-Type: application/x-www-form-urlencoded Hello World
理解 HTTP 協議本身;熟練使用相關 API;注意 GET 與 POST 在處理細節上的差異;透徹理解 requestListener 在事件迴圈中的位置。最後再強調一次:request 是可讀流,response 是可寫流——這個特性直接決定了後續處理檔案上傳、串流回應等場景的寫法。