前端学习笔记 · 第 118 天：用 node:http 搭一个服务器——方法、路径、请求头与请求体

Day 118 · 第五阶段 · Node.js 与后端开发

今天换一个方向：不再由脚本主动访问外部，而是让脚本自己监听端口，接收别人发来的请求。

这一步是前后端的接缝。浏览器发出的请求，最终由一个这样的服务器接收；理解了服务器手里的请求对象，前面学过的报文、方法、头部才有落点。

今天先做前半段：创建服务器、读请求行与头部、读请求体、处理连接错误；响应的状态码与响应头留到下一节。

一、问题现场

四个常见的起步问题：

• 回调里想读请求体，打印出来是 undefined。请求对象的正文不在字段上，而是一条事件流，头部到齐时它还没到达。
• 用 req.headers["X-Token"] 取不到值。头部键名被统一转成小写，取 x-token 才对。
• 端口被占用，启动没有报错，或者报错后进程直接退出、堆栈里只有一行 EADDRINUSE。默认行为是抛出未捕获异常，没有监听器就没有人处理。
• 客户端上传到一半断开，服务端什么也没记录，以为请求处理完了。end 没有触发，处理逻辑根本没执行。

四个问题都落在「请求对象怎么用」上：哪个字段在什么时候可用、流什么时候结束、错误发生在谁身上。

二、创建服务器

node:http 的入口是 createServer，参数是一个回调，每个请求进来调用一次。回调拿到的第一个参数是请求对象，第二个是响应对象。

const server = createServer((req, res) => {    res.end("ok");});server.listen(3018, () => {    console.log("监听", server.address().port);});

listen 的第一个参数是端口，第二个是监听成功后的回调。server.address() 返回实际绑定的地址，实测在未指定主机时得到 { address: '::', family: 'IPv6', port: 3018 }，表示双栈监听，IPv4 与 IPv6 都能连上；本机回环请求的 req.socket.remoteAddress 因此是 ::1。

端口被占用时，listen 不会同步抛错，而是把错误交给 server 的 error 事件。没有注册监听器，运行时会把这次错误当成未捕获异常，进程以退出码 1 结束，堆栈里能看到 Unhandled 'error' event 与 EADDRINUSE。注册之后就能自己决定怎么处理：

服务器错误: listen EADDRINUSE: address already in use :::3018

三、请求对象

请求对象上的字段来自请求行与头部。实测一个 GET /hello?name=1 的请求，回调里能读到：

• req.method
   是大写的方法名，GET、POST。
• req.url
   是路径加查询串，原样保留，不做解析；查参数要自己按 ? 与 & 拆，或者交给 URL 构造。
• req.httpVersion
   是字符串 1.1，与请求行里的版本一致。
• req.headers
   是对象，键名统一小写；值要么是字符串，要么是数组。
• req.rawHeaders
   是扁平数组，保留原始大小写，适合原样转发。

头部大小写与重复值有两条实测规则。发一个 X-Mixed-Case: One 的请求，服务端读到的键是 x-mixed-case；同一头部发两次，普通头的两个值会合并成一个字符串 a, b，因此按字符串比较时要注意逗号与空格。需要原始形态时用 rawHeaders，它返回成对排列的数组，大小写保持原样：

["host","localhost:3020","connection","keep-alive","X-AbC","v"]

四、读取请求体

请求体不是字段，是流。头部到齐时回调执行，正文随后按块到达，每块都是一个 Buffer。读法固定为三步：监听 data 累积、监听 end 拼接、处理完再响应。

const chunks = [];req.on("data", (chunk) => chunks.push(chunk));req.on("end", () => {    const body = Buffer.concat(chunks).toString("utf8");    res.end(body);});

两个与长度有关的细节。带 content-length 的请求，头部里能直接读到字节数；用分块传输的请求没有这个头，实测只有 transfer-encoding: chunked，正文长度要等 end 之后按字节算。toString("utf8") 放在拼接之后执行一次，比每块单独转码更省事，也避免多字节字符被截断。

五、错误处理

请求链路上有两类错误，处理方式不同。

第一类来自客户端。上传中途断开时，end 不会触发，req.complete 保持 false，close 事件仍然会来。因此判断「请求是否完整」用 complete，而不是「回调有没有执行」：

req.on("close", () => {    if (!req.complete) console.log("客户端提前断开");});

实测把连接在正文发到一半时销毁，服务端打印出「客户端提前断开」。

第二类来自服务器自身。端口占用、监听失败都属于这一组，由 server.on("error") 接收。处理时给出可读的原因，并把退出码置为非零，交给进程管理器判断：

server.on("error", (error) => {    console.error("服务器错误:", error.message);    process.exitCode = 1;});

两类错误都不应该被静默吞掉。客户端断开只是少了一次处理，记录之后继续服务；监听失败则意味着这个进程无法工作，应当退出。

六、实战示例：回显服务器

把前面的字段与事件收进一个文件：任何请求都回显方法、路径、协议版本、host 头、长度与正文。响应用 res.end 一次性写出，状态码与响应头的写法留到下一节。

// server.mjs —— 回显请求的方法、路径、头部与正文import { createServer } from "node:http";const server = createServer((req, res) => {    const chunks = [];    req.on("data", (chunk) => chunks.push(chunk));    req.on("close", () => {        if (!req.complete) console.log("客户端提前断开");    });    req.on("end", () => {        const body = Buffer.concat(chunks).toString("utf8");        const lines = [            `${req.method} ${req.url}`,            `HTTP/${req.httpVersion}`,            `host: ${req.headers.host ?? "（无）"}`,            `length: ${req.headers["content-length"] ?? 0}`,            `body: ${body || "（空）"}`,        ];        res.end(lines.join("\n"));    });});server.on("error", (error) => {    console.error("服务器错误:", error.message);    process.exitCode = 1;});server.listen(3018, () => {    console.log("监听", server.address().port);});

启动后请求 /hello，回显五行：

GET /hello?name=1HTTP/1.1host: localhost:3018length: 0body: （空）

再发一个 JSON 的 POST，长度与正文都对得上：

POST /echoHTTP/1.1host: localhost:3018length: 26body: {"name":"小明","age":28}

length 是 26 而不是字符数，因为 content-length 按字节计算，两个汉字各占 3 字节。这也解释了为什么拼接时用 Buffer 而不是字符串：直到 end 之前，拿到的都是字节块。

再把同一份文件启动两次，第二次会走错误分支：

服务器错误: listen EADDRINUSE: address already in use :::3018

常见问题

Q1：回调里打印 req.body 为什么是 undefined？

请求对象没有 body 字段。正文是一条可读流，要监听 data 累积、监听 end 拼接，拿到完整内容后才能解析。头部到齐时回调就执行了，此刻正文往往还在传输。

Q2：req.headers 里取不到自定义头，是不是没收到？

先看键名大小写。头部键名统一转成小写，X-Token 要按 x-token 取。取不到再用 rawHeaders 确认请求里是否真的带了这一行。

Q3：同一头部发了两次，为什么读到的是一段带逗号的字符串？

普通头部的重复值会被合并成一个字符串，用逗号与空格分隔，这是 Node 的归一化结果。需要逐条读取时用 rawHeaders，它保留每次出现的原始条目。

Q4：没有 content-length 的请求怎么判断长度？

用分块传输时，头部只有 transfer-encoding: chunked，没有总长度。等 end 之后按拼接后的字节数计算，或者边收边计数。

Q5：端口被占用时为什么进程直接退出了？

listen 的错误通过 error 事件上报，没有监听器就是未捕获异常，进程以退出码 1 结束。注册 server.on("error") 之后可以打印原因、设置退出码，再按部署方式处理。

Q6：客户端中途断开，服务端会收到 end 吗？

不会。连接关闭时触发的是 close，complete 为 false。依赖 end 的处理逻辑不会执行，因此需要单独监听关闭事件，记录未完成的请求。

知识点总结

• 创建服务器：

  每个请求执行一次 createServer 注册的回调，listen 绑定端口并接收错误事件

• 监听地址：

  未指定主机时绑定 ::，address() 返回地址、协议族与端口

• 请求行：

  方法为大写、url 含查询串且未解析、httpVersion 是字符串

• 头部：

  请求头在 headers 里键名小写，普通头的重复值合并为逗号分隔的字符串

• 原始头部：

  原始顺序与大小写由 rawHeaders 保留，成对排列，适合原样转发

• 请求体：

  不是字段而是流，按 data 累积、end 拼接，块为 Buffer

• 长度：

  字节数由 content-length 给出；分块传输时没有该头，只能等 end 后计算

• 客户端断开：

  触发 close 而非 end，complete 为 false

• 服务端错误：

  端口占用等通过 error 事件上报，不处理会成为未捕获异常

（本文为学习笔记整理）