HTTP 响应处理:状态码、响应头与 JSON 数据
🎯 引言
学完这篇文章,你能在接口中正确返回状态码、响应头、JSON 和无正文响应。
📤 返回 JSON 数据
新建 response-server.mjs:
import express from 'express';
const app = express();
添加查询接口:
app.get('/users/1', (req, res) => {
res.json({ id: 1, name: '小明' });
});
访问 /users/1 返回状态 200 和 {"id":1,"name":"小明"}。res.json 自动设置 JSON 类型并转换对象,不要先调用 JSON.stringify 再交给它,否则可能把 JSON 字符串当成数据返回。
🚦 创建成功时设置状态码
创建接口通常返回 201。下面用固定记录演示响应,尚未写入数据库:
app.post('/users', (req, res) => {
res.status(201).json({ id: 2, name: '小红' });
});
status(201) 设置状态,json 发送正文并结束响应。只调用 status 不会把响应发出去。
🧾 响应头在发送正文之前设置
如果要告诉客户端新资源的位置,将上一节的 POST 路由替换为:
app.post('/users', (req, res) => {
res.location('/users/2');
res.status(201).json({ id: 2, name: '小红' });
});
响应多出 Location: /users/2。location 只设置地址,不会让这个 201 响应自动变成跳转。发送正文后再改响应头会失败,因此设置必须在 json 之前。
🫙 删除成功可以不返回正文
只需要告诉客户端操作已完成时,可以返回 204:
app.delete('/users/1', (req, res) => {
res.status(204).end();
});
本例只演示成功响应,没有真实删除数据。204 没有正文,客户端不应再调用 JSON 解析。需要返回删除后的信息时,可另行约定使用 200 和 JSON。
⚠️ 失败使用对应状态
下面用固定缺失的用户演示 404:
app.get('/users/999', (req, res) => {
res.status(404).json({ error: '用户不存在' });
});
响应状态和正文都表达失败。不要只在正文写“失败”却保留 200。一个请求发送一份响应,条件分支发送后应退出当前处理流程,避免后面再次发送。
🧪 观察状态、头部与正文
将监听放在文件末尾:
app.listen(3000, '127.0.0.1');
运行 node response-server.mjs,另开终端发送:
curl -i -X POST http://127.0.0.1:3000/users
得到 201 和用户 JSON;替换过 Location 示例后还会看到对应响应头。改为请求 GET /users/999 得到 404,DELETE /users/1 得到无正文的 204。
❓ 知识问答
Q1:JSON 响应必须放在 data 字段里吗?
不必须。字段结构由接口约定,项目内保持一致即可。
Q2:res.json 后要再调用 end 吗?
不需要,json 已发送并结束响应。
Q3:数据库记录可以原样返回吗?
应只选择允许公开的字段,不能把密码记录等内部数据返回客户端。
🧪 小练习
新增 /users/3 查询接口,分别检查成功和不存在时的状态码与正文。
// 请在这里编写代码
