使用原生 Node.js 创建 HTTP 服务器

启动本地 HTTP 服务,并理解请求对象、响应对象与监听端口

🎯 引言

学完这篇文章,你能启动本地 HTTP 服务,并理解请求对象、响应对象与监听端口。

🧱 先写一次请求的处理函数

在 backend-demo 目录新建 hello.mjs。下面是完整函数,接收请求后返回文本:

hello.mjs
export function hello(req, res) {
    res.setHeader('Content-Type', 'text/plain; charset=utf-8');
    res.end('你好,Node.js');
}

req 是这一次请求的信息,res 是这一次响应的出口。end 发送正文并结束响应;缺少结束操作时,客户端可能一直等待。这里所有地址都返回相同文本,先确认服务能接到请求。


🔌 创建服务,再监听端口

新建 hello-server.mjs,导入处理函数并创建服务对象:

hello-server.mjs
import { createServer } from 'node:http';
import { hello } from './hello.mjs';

const server = createServer(hello);

createServer 为每个请求调用 hello。它返回服务对象,但此时还没开始接收网络连接。

继续在同一文件添加监听:

hello-server.mjs
server.listen(3000, '127.0.0.1', () => {
    console.log('http://127.0.0.1:3000');
});

3000 是监听端口;127.0.0.1 只允许本机访问,适合练习。回调执行说明监听成功,不代表所有业务接口已经通过测试。


🧪 从客户端验证结果

运行服务:

node hello-server.mjs

另开终端请求它。curl 是终端 HTTP 请求工具,-i 同时显示响应头:

curl -i http://127.0.0.1:3000

应看到 200 OK、文本类型的 Content-Type 和正文“你好,Node.js”。浏览器访问同一地址也会显示这句话。

服务会持续等待请求,不会返回一次就退出。修改代码后停止并重新运行;也可以使用开发监听模式:

node --watch hello-server.mjs

文件修改后 Node.js 会重新启动进程。它适合开发,不负责正式环境的崩溃恢复。


⚠️ 区分启动失败与请求失败

EADDRINUSE 表示端口已被其他程序占用,常见原因是上一份示例仍在运行。先在旧终端按 Ctrl+C 停止,再启动当前示例。

监听成功后某次请求返回错误,是另一类问题,需要检查处理函数。不要用更换端口掩盖业务错误,也不要同时启动本课程的多个 3000 端口服务。


❓ 知识问答

Q1:一次请求会启动一个新的 Node.js 进程吗?

不会。这里同一个服务进程处理多次请求,每次得到各自的 req 和 res。

Q2:为什么手机不能访问这个地址?

127.0.0.1 指当前设备自身,而且服务只监听本机。跨设备访问需要正确监听地址和网络配置。

Q3:res.end 以后还能继续发一份响应吗?

不能。一次请求只有一份响应。处理完应结束当前函数流程,避免后续逻辑再次写响应。


🧪 小练习

将正文改为自己的昵称,重启后分别用浏览器和 curl 验证。再停止服务,观察客户端得到的是连接失败,而不是 HTTP 404。

// 请在这里编写代码或记录验证结果