路由匹配与请求处理流程:理解 Web 框架原理
🎯 引言
学完这篇文章,你能用请求方法和路径定义接口,并安排公共处理步骤在接口前执行。
🧭 让不同请求进入各自的接口
路由负责将请求交给对应的处理函数。 使用 Express 开发接口时,直接用 app.get、app.post 等方法声明规则,框架负责匹配。
新建 routing-app.mjs:
import express from 'express';
export const app = express();
应用导出后,启动文件和测试都能使用它。
先记录请求,再进入接口
需要记录每次请求的方法和地址时,在路由前添加中间件:
app.use((req, res, next) => {
console.log(req.method, req.path);
next();
});
next() 把请求交给后续处理。如果既不响应也不调用 next,请求就会一直等待。这里记录的是不含查询参数的路径,避免把查询中的敏感值写入日志。
用户列表接口
添加列表接口:
app.get('/users', (req, res) => {
res.json({ data: [{ id: 1, name: '小明' }] });
});
请求 GET /users 时执行这个回调,得到 200 和用户数组。POST /users 不会进入它,GET /users?name=小明 则仍会匹配,查询参数由处理函数另行使用。
健康检查接口
在同一文件添加另一个接口:
app.get('/health', (req, res) => {
res.json({ status: 'ok' });
});
它返回 200 和 {"status":"ok"},用于检查 HTTP 服务能否响应。没有访问数据库,因此不能据此判断数据库是否正常。
🔀 匹配过程与代码顺序
请求 GET /users 时,先执行日志中间件,调用 next 后匹配用户路由,发送 JSON 后结束。框架内部根据已登记的方法和路径完成查找,我们编写的是接口行为。
要给接口增加身份检查,就把检查放在业务处理之前;失败直接返回 401,通过才继续。路由 API、动态路径顺序与 Router 拆分见 Express 路由。
🚫 在路由之后处理未匹配请求
两个路由都没有匹配时,返回统一的 404:
app.use((req, res) => {
res.status(404).json({ error: '接口不存在' });
});
这段必须放在路由后面,否则会提前结束请求。当前没有定义 POST /users,它也返回 404;Express 不会自动为已知路径生成 405。若接口规范要求 405,应另行配置允许方法。
🚀 启动并验证
新建 routing-server.mjs,只负责监听:
import { app } from './routing-app.mjs';
app.listen(3000, '127.0.0.1');
运行 node routing-server.mjs 后请求用户接口:
curl -i http://127.0.0.1:3000/users
响应为 200 和用户列表,服务端打印 GET /users。请求 /health 得到 ok,请求 /missing 得到 404。
❓ 知识问答
Q1:加上 /health 就能判断数据库正常吗?
不能,本例只返回固定结果。需要判断数据库是否可用时,健康检查还要实际检查数据库连接。
Q2:接口越来越多怎么办?
使用 Express Router 按用户、文件等功能拆分,具体语法见 Express 路由。
Q3:公共身份检查应该放在哪里?
放在需要保护的路由之前,认证失败就发送错误并结束,认证通过才继续。
🧪 小练习
在 404 处理之前新增 GET /version,返回版本对象,并确认未知路径仍返回 404。
// 请在这里编写代码
