Node.js / 系统课时
定义路由与处理函数
定义路由与处理函数
这一课把 Express 应用扩展成一组可验证的 HTTP 接口:用“请求方法 + 路径”选择处理函数,从路径参数、查询参数和 JSON 请求体读取输入,再分别返回文本、JSON 与明确的状态码。
学习目标
- 使用
app.get()、app.post()按 HTTP 方法和路径定义路由。 - 从
req.params、req.query、req.body读取三类常见输入。 - 使用
res.send()、res.json()和res.status()返回可验证的响应。
用方法和路径确定处理函数
Express 路由不是只看 URL。GET /users/u-42 与 POST /users/u-42 可以进入不同处理函数;/users/:id 中的 :id 会进入 req.params.id,而 ?detail=1 不参与路径匹配,值从 req.query.detail 读取。

可以先用这张最小路由表规划接口,再写代码:
| 方法 | 路径 | 输入 | 成功状态 |
|---|---|---|---|
| GET | /health |
无 | 200 |
| GET | /users/:id |
id、可选 detail |
200 |
| POST | /users |
JSON name |
201 |
编写可运行的路由示例
在项目中安装 Express 后,把 app.js 改成下面的完整程序。express.json() 必须放在读取 req.body 的路由之前,否则 JSON 请求体不会被该中间件解析。
const express = require('express');
const app = express();
const PORT = 3000;
// 解析 Content-Type 为 application/json 的请求体。
app.use(express.json());
app.get('/health', (req, res) => {
res.json({ ok: true });
});
app.get('/users/:id', (req, res) => {
res.json({
id: req.params.id,
detail: req.query.detail === '1'
});
});
app.post('/users', (req, res) => {
const name = typeof req.body?.name === 'string' ? req.body.name.trim() : '';
if (!name) {
return res.status(400).json({ error: 'name is required' });
}
res.status(201).json({ id: 'u-1001', name });
});
// 自定义兜底,让未匹配路由也保持 JSON 响应。
app.use((req, res) => {
res.status(404).json({ error: 'not found' });
});
app.listen(PORT, (error) => {
if (error) {
console.error(error.code ?? error.message);
process.exitCode = 1;
return;
}
console.log(`Listening on http://localhost:${PORT}`);
});运行服务:
node app.js预期输出:
Listening on http://localhost:3000请求接口并核对响应
另开终端执行下面四个请求。这里用 curl -sS 只显示响应体,便于直接核对路由是否进入了预期处理函数。
curl -sS http://localhost:3000/health
echo
curl -sS "http://localhost:3000/users/u-42?detail=1"
echo
curl -sS -X POST http://localhost:3000/users -H "Content-Type: application/json" -d '{"name":"Ada"}'
echo
curl -sS http://localhost:3000/missing预期输出:
{"ok":true}
{"id":"u-42","detail":true}
{"id":"u-1001","name":"Ada"}
{"error":"not found"}前三个响应分别验证固定路径、路径参数加查询参数、JSON 请求体。最后一个请求没有命中任何业务路由,因此落到兜底中间件并返回 404;若把兜底放到业务路由之前,后面的路由将永远没有机会执行。
区分响应方法与常见边界
res.send('ok') 适合返回文本或简单内容,res.json({ ok: true }) 会把对象序列化为 JSON,res.status(201).json(...) 则先设置状态码再发送 JSON。一个处理函数发送响应后通常应结束当前分支,尤其是 return res.status(400).json(...) 这种提前返回,避免后续代码再次发送响应。
| 情况 | Express 行为 | 建议 |
|---|---|---|
| 路径存在但 HTTP 方法不匹配 | 继续寻找后续路由;若最终无匹配则进入 404 | 需要 405 时显式实现方法检查 |
JSON 请求体缺少 express.json() |
req.body 不会得到预期的已解析对象 |
在相关路由之前注册中间件 |
| 路径参数缺失 | /users/:id 不匹配 /users/ |
为集合接口单独定义 /users |
已发送响应后继续 res.json() |
可能触发“headers already sent”错误 | 发送后 return 或保证分支互斥 |
路由数量增加后,可以再用 express.Router() 按业务模块拆文件;在只有三五个接口时,先把方法、路径、输入和状态码定义清楚,比过早拆分目录更容易验证。