Node.js / 系统课时
创建 HTTP 服务器
创建 HTTP 服务器
这一课直接用 Node.js 内置 http 模块启动一个可访问的本地服务。完成后你会得到一个监听 127.0.0.1:3000 的服务器,并能用 curl 验证响应正文和监听状态。
学习目标
- 用
http.createServer()创建服务器并处理请求。 - 用
server.listen()绑定监听地址和端口。 - 用
curl验证服务是否真的返回预期内容。
写出最小可用服务器
新建 server.js。请求监听函数会收到 req 和 res 两个对象;这一课先不读取请求,只返回固定文本。显式设置状态码、内容类型和字节长度,便于后续观察 HTTP 响应。
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。
node server.js预期输出:
Listening on http://127.0.0.1:3000保持服务器运行,再开一个终端请求根路径。
curl http://127.0.0.1:3000/预期输出:
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 响应的完整闭环。