Node.js / 系统课时

创建 HTTP 服务器

创建 HTTP 服务器

这一课直接用 Node.js 内置 http 模块启动一个可访问的本地服务。完成后你会得到一个监听 127.0.0.1:3000 的服务器,并能用 curl 验证响应正文和监听状态。

学习目标

  • 用 http.createServer() 创建服务器并处理请求。
  • 用 server.listen() 绑定监听地址和端口。
  • 用 curl 验证服务是否真的返回预期内容。

写出最小可用服务器

新建 server.js。请求监听函数会收到 req 和 res 两个对象;这一课先不读取请求,只返回固定文本。显式设置状态码、内容类型和字节长度,便于后续观察 HTTP 响应。

js
const http = require('http');

const host = '127.0.0.1';
const port = 3000;

const server = http.createServer((req, res) => {
  const body = 'Hello Node!\n';

  // 明确响应元数据,再结束本次响应。
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain; charset=utf-8');
  res.setHeader('Content-Length', Buffer.byteLength(body));
  res.end(body);
});

server.listen(port, host, () => {
  console.log('Listening on http://' + host + ':' + port);
});

这里的 Content-Length 按字节计算,所以使用 Buffer.byteLength(body),不要直接把 JavaScript 字符串的 length 当作任意文本的网络字节数。res.end() 会结束当前响应,固定正文不需要再调用 res.write()。

启动并验证响应

在保存 server.js 的目录运行 Node.js。该进程会持续监听端口,不会自动退出;需要停止时在当前终端按 Ctrl+C。

bash
node server.js

预期输出:

text
Listening on http://127.0.0.1:3000

保持服务器运行,再开一个终端请求根路径。

bash
curl http://127.0.0.1:3000/

预期输出:

text
Hello Node!

如果这里能看到完全一致的正文,说明 TCP 端口已监听、HTTP 请求已进入回调、响应也已经正常结束。浏览器访问 http://127.0.0.1:3000/ 也会看到同一行文本。

监听地址和端口怎么选

本地学习时优先绑定 127.0.0.1,这样只有本机能够连接;需要让同一局域网中的其他设备访问时,才考虑监听 0.0.0.0,并同时检查系统防火墙。开发端口常用 3000、8080 等非特权端口。

设置 适用场景 直接结果
127.0.0.1:3000 本机开发 仅本机访问
0.0.0.0:3000 局域网联调或容器暴露 所有本机网络接口都监听
端口 0 测试代码需要系统自动分配端口 实际端口要从 server.address() 读取

如果启动时报 EADDRINUSE,表示目标地址上的端口已经被其他进程占用。最直接的修复是停止占用者,或把示例中的 port 改成未使用端口;不要通过重复启动进程来重试同一个端口。

检查响应是否完整

这个最小服务的验收条件只有三项:启动终端出现监听地址、curl 能收到 Hello Node!、停止进程后同一请求无法继续成功。三项都满足,说明你已经完成了从监听端口到写回 HTTP 响应的完整闭环。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 HTTP 服务器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通