差别
这里会显示出您选择的修订版和当前版本之间的差别。
| 代码术语:req和res [2026/11/11 14:50] – 创建 张叶安 | 代码术语:req和res [2026/11/11 14:51] (当前版本) – 补全 req 和 res(请求与响应)词条:含义、职责、对照表、各框架写法、常见坑 张叶安 | ||
|---|---|---|---|
| 行 1: | 行 1: | ||
| - | 1 | + | ====== req 和 res(请求与响应) ====== |
| + | |||
| + | **'' | ||
| + | |||
| + | * **'' | ||
| + | * **'' | ||
| + | |||
| + | > **一句话**:'' | ||
| + | |||
| + | 这个命名在 Node.js / Express 生态里几乎人尽皆知,因为每个处理器都长这样: | ||
| + | |||
| + | <code javascript> | ||
| + | app.get("/ | ||
| + | const id = req.params.id; | ||
| + | res.json({ id }); // 往 res 写 | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | ===== 一、为什么不叫 request / response ===== | ||
| + | |||
| + | 纯粹是**约定俗成的短写**:这两个对象在几乎每个函数签名里都要出现,写全名太长,社区统一缩成 '' | ||
| + | |||
| + | | 写法 | 出处 | 说明 | | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | **名字不同,角色是同一个**:一个是「进来的请求」,一个是「出去的回答」。 | ||
| + | |||
| + | ===== 二、req:只读的输入 ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | ==== 2.1 请求行 ==== | ||
| + | |||
| + | | 属性 | 含义 | | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | ==== 2.2 头部与来源 ==== | ||
| + | |||
| + | | 属性 | 含义 | | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | ==== 2.3 请求体 ==== | ||
| + | |||
| + | '' | ||
| + | |||
| + | * 原生 Node 里 '' | ||
| + | * Express 4/5 中要显式挂上解析中间件('' | ||
| + | * 这也是新手报「'' | ||
| + | |||
| + | <code javascript> | ||
| + | app.use(express.json()); | ||
| + | |||
| + | app.post("/ | ||
| + | const { amount } = req.body ?? {}; // 保守写法 | ||
| + | res.status(201).json({ amount }); | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | ==== 2.4 使用纪律 ==== | ||
| + | |||
| + | * **默认当作只读**。往 '' | ||
| + | * 不要指望 '' | ||
| + | |||
| + | ===== 三、res:只能写一次的输出 ===== | ||
| + | |||
| + | '' | ||
| + | |||
| + | > **响应头一旦发出(第一次 '' | ||
| + | |||
| + | ==== 3.1 常用方法 ==== | ||
| + | |||
| + | | 方法 | 作用 | | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | ==== 3.2 两条最容易踩的规则 ==== | ||
| + | |||
| + | * **必须 '' | ||
| + | * **不能发两次**:第二次发送会抛 '' | ||
| + | |||
| + | <code javascript> | ||
| + | app.get("/ | ||
| + | try { | ||
| + | const u = await repo.find(req.params.id); | ||
| + | if (!u) return res.status(404).json({ error: " | ||
| + | return res.json(u); | ||
| + | } catch (e) { | ||
| + | if (res.headersSent) return next(e); | ||
| + | return res.status(500).json({ error: " | ||
| + | } | ||
| + | }); | ||
| + | </ | ||
| + | |||
| + | ===== 四、一张对照表 ===== | ||
| + | |||
| + | | 维度 | '' | ||
| + | | 数据方向 | 浏览器 → 服务器 | 服务器 → 浏览器 | | ||
| + | | 角色 | **输入**,主要在读 | **输出**,主要在写 | | ||
| + | | 底层类型(Node) | '' | ||
| + | | 能不能重复操作 | 可以反复读属性 | **只能写一次**,写完即结束 | | ||
| + | | 关键内容 | method / 路径 / 头 / body | status / 头 / body | | ||
| + | | 谁构造 | 由框架根据 HTTP 报文创建 | 由框架创建,你往里填 | | ||
| + | | 常见错误 | 读 '' | ||
| + | |||
| + | ===== 五、三处输入别搞混 ===== | ||
| + | |||
| + | 面试和实际开发里最高频的混淆点: | ||
| + | |||
| + | | 来源 | 位置 | 取值 | 例 | | ||
| + | | '' | ||
| + | | '' | ||
| + | | '' | ||
| + | |||
| + | 推论:'' | ||
| + | |||
| + | ===== 六、其他语言 / 框架里的同一对角色 ===== | ||
| + | |||
| + | | 框架 | 写法 | 备注 | | ||
| + | | Express | '' | ||
| + | | Next.js API 路由 | '' | ||
| + | | NestJS | '' | ||
| + | | Koa | '' | ||
| + | | Go | '' | ||
| + | | Java Servlet | '' | ||
| + | | Python Flask | 全局 '' | ||
| + | |||
| + | 可以看到一个共同规律:**请求对象由框架交给你读,响应对象由你填完交回框架发出去**。这是几乎所有 Web 框架的同构设计。 | ||
| + | |||
| + | ===== 七、常见坑 ===== | ||
| + | |||
| + | | 坑 | 说明 | | ||
| + | | '' | ||
| + | | '' | ||
| + | | 没装解析中间件就读 '' | ||
| + | | 用 '' | ||
| + | | 相信 '' | ||
| + | | 把 '' | ||
| + | | '' | ||
| + | | 在 '' | ||
| + | | 手动改 '' | ||
| + | |||
| + | ===== 八、30 秒自测 ===== | ||
| + | |||
| + | * '' | ||
| + | * 哪个是只读输入,哪个是只能写一次的输出?→ **'' | ||
| + | * '' | ||
| + | * ''/ | ||
| + | * 响应已经发出去了,还能改状态码吗?→ **不能** | ||
| + | * 为什么 '' | ||
| + | |||
| + | ===== 九、一句话记住 ===== | ||
| + | |||
| + | > **'' | ||
| + | |||
| + | ```mdk height=560 color=# | ||
| + | # req 和 res | ||
| + | ## 是什么 | ||
| + | - req = request 请求 | ||
| + | - res = response 响应 | ||
| + | - 一次 HTTP 交互的两端 | ||
| + | - req:只读的输入 | ||
| + | - res:只能写一次的输出 | ||
| + | ## 底层类型 | ||
| + | - req → http.IncomingMessage | ||
| + | - res → http.ServerResponse | ||
| + | - Express 在其上加了语法糖 | ||
| + | ## req 里有什么 | ||
| + | ### 请求行与路径 | ||
| + | - req.method | ||
| + | - req.path / req.originalUrl | ||
| + | - req.params:路径参数 | ||
| + | - req.query:查询串 | ||
| + | ### 头部 | ||
| + | - req.headers / req.get() | ||
| + | - req.cookies | ||
| + | - req.ip / req.protocol | ||
| + | - 反向代理下要配 trust proxy | ||
| + | ### 主体 | ||
| + | - req.body 依赖解析中间件 | ||
| + | - 原生是流:req.on(' | ||
| + | - 没中间件就是 undefined | ||
| + | ### 纪律 | ||
| + | - 默认只读 | ||
| + | - 自定义挂载避开框架字段 | ||
| + | ## res 里有什么 | ||
| + | ### 状态与头 | ||
| + | - res.status() | ||
| + | - res.set() / res.header() | ||
| + | - res.cookie() | ||
| + | - 头发出后不可再改 | ||
| + | ### 输出 | ||
| + | - res.send() / res.json() | ||
| + | - res.end() | ||
| + | - res.redirect() | ||
| + | - res.sendFile() / res.render() | ||
| + | ### 硬约束 | ||
| + | - 是流,写完即结束 | ||
| + | - 只能发送一次 | ||
| + | - 二次发送抛 ERR_HTTP_HEADERS_SENT | ||
| + | - 记得 return | ||
| + | ## 三处输入别混 | ||
| + | - req.params:路径占位符 | ||
| + | - req.query:始终是字符串 | ||
| + | - req.body:需解析 | ||
| + | ## 各框架的同一对 | ||
| + | - Express:(req, | ||
| + | - Next.js:NextApiRequest / NextApiResponse | ||
| + | - NestJS:@Req() / @Res(),自己响应 | ||
| + | - Koa:ctx.request / ctx.response / ctx.body | ||
| + | - Go:w ResponseWriter, | ||
| + | - Java:ServletRequest / ServletResponse | ||
| + | - Flask:全局 request + 返回值 | ||
| + | ## 常见坑 | ||
| + | - res.json 后忘 return | ||
| + | - try 和 catch 各发一次响应 | ||
| + | - 没中间件就读 req.body | ||
| + | - 拿 query 当路径参数 | ||
| + | - 把 res 当 Promise await | ||
| + | - async 异常没捕获,请求挂起 | ||
| + | - 相信客户端传来的头部 | ||
| + | ## 一句话 | ||
| + | - req 读进来、res 写回去 | ||
| + | - 方向相反,res 只能写一次 | ||
| + | ``` | ||
| + | |||
| + | ===== 参考 ===== | ||
| + | |||
| + | * Express 文档 —— [[https:// | ||
| + | * Node.js 文档 —— [[https:// | ||
| + | * MDN —— [[https:// | ||
| + | * Koa 文档 —— [[https:// | ||
| + | * RFC 9110 —— [[https:// | ||
| + | |||
| + | 相关:[[express]] · [[nodejs]] · [[代码术语: | ||
| + | |||
| + | ---- | ||
| + | |||
| + | 返回:[[代码术语]] | ||