使用原生 Node.js 创建 HTTP 服务器
🎯 引言
学完这篇文章,你能启动本地 HTTP 服务,并理解请求对象、响应对象与监听端口。
🧱 先写一次请求的处理函数
在 backend-demo 目录新建 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,导入处理函数并创建服务对象:
import { createServer } from 'node:http';
import { hello } from './hello.mjs';
const server = createServer(hello);
createServer 为每个请求调用 hello。它返回服务对象,但此时还没开始接收网络连接。
继续在同一文件添加监听:
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。
// 请在这里编写代码或记录验证结果
