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 读取。

Express 路由按方法和路径分发到处理函数

可以先用这张最小路由表规划接口,再写代码:

方法 路径 输入 成功状态
GET /health 无 200
GET /users/:id id、可选 detail 200
POST /users JSON name 201

编写可运行的路由示例

在项目中安装 Express 后,把 app.js 改成下面的完整程序。express.json() 必须放在读取 req.body 的路由之前,否则 JSON 请求体不会被该中间件解析。

js
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}`);
});

运行服务:

bash
node app.js

预期输出:

text
Listening on http://localhost:3000

请求接口并核对响应

另开终端执行下面四个请求。这里用 curl -sS 只显示响应体,便于直接核对路由是否进入了预期处理函数。

bash
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

预期输出:

text
{"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() 按业务模块拆文件;在只有三五个接口时,先把方法、路径、输入和状态码定义清楚,比过早拆分目录更容易验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义路由与处理函数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通