原生 HTTP 服务用 http.createServer() 配合 server.listen(),需手动处理状态码、响应头、res.end();Express 是其封装,提供路由、中间件、增强的 req/res 等能力,可维护性更强。

Node.js 启动一个最简 HTTP 服务用什么函数
用 http.createServer() 配合 server.listen() 就能跑起来,不需要框架。它底层直接封装了 TCP 连接和 HTTP 解析,适合理解原理或写极轻量接口。
常见错误是忘记调用 res.end(),导致请求一直挂起;或者没设 Content-Type,浏览器把 JSON 当文本渲染。
- 必须手动写状态码、响应头、响应体
- 每次请求都新建
req/res对象,不自动解析 query/body - 没有路由、中间件、错误统一处理机制
const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, { 'Content-Type': 'application/json' });
res.end(JSON.stringify({ message: 'Hello from raw Node.js' }));
});
server.listen(3000);
Express 和原生 http 模块的关键区别在哪
express() 本质是对 http.createServer() 的封装,加了路由匹配、中间件链、req/res 增强(如 req.query、res.json())等能力。它不改底层,只是让开发更省力。
性能上差异微乎其微(Express 多几层函数调用),但可维护性提升明显。别为了“纯”而硬写原生——除非你在做中间件、代理或协议转换类工具。
立即学习“Java免费学习笔记(深入)”;
-
app.use()注册中间件,顺序敏感;app.get()等只响应特定 method -
req.body默认为空,需配合express.json()或express.urlencoded() - 错误中间件必须带 4 个参数:
(err, req, res, next)
为什么用 process.env.PORT 而不是写死 3000
本地开发时端口写死没问题,但部署到 Heroku、Vercel、Docker 或 Kubernetes 时,平台会通过环境变量指定可用端口。PORT 是事实标准,不读它会导致服务启动成功却无法访问。
Node.js 不会自动 fallback,process.env.PORT 是字符串,必须转成数字再传给 listen(),否则报错 ERR_INVALID_ARG_TYPE。
- 推荐写法:
const port = parseInt(process.env.PORT, 10) || 3000 - 本地测试可执行
PORT=8080 node server.js - Docker 容器里常通过
-e PORT=5000注入
Node.js 后端服务必须处理的三类错误
未捕获的异常(uncaughtException)、未处理的 Promise 拒绝(unhandledRejection)、HTTP 请求级错误(如 404、500)。前两者会直接 crash 进程,第三种靠中间件兜底。
别用 try/catch 包整个 createServer —— 它不抛错;重点在请求处理内部和异步操作中补 catch,并用 next(err) 交由错误中间件。
-
process.on('uncaughtException', () => process.exit(1))只用于日志+退出,不能恢复服务 -
process.on('unhandledRejection', (reason) => console.error(reason))必须监听,否则进程静默退出 - 错误中间件最后要
res.status(500).json({ error: 'Internal server error' }),避免空响应
真正难的不是启动服务,是让服务在出错时不崩、在并发时不慢、在换环境时不改代码。端口、错误流、请求体解析这三处,90% 的新手卡点都在这儿。
