如何设置HTTP响应头并使用send方法发送JSON格式数据？

本文共计993个文字，预计阅读时间需要4分钟。

直接返回JSON数据，内容如下：

PHP 中用 header() 和 echo json_encode() 返回 JSON

PHP 没有内置的“JSON 响应对象”，靠手动设置 header + 输出字符串。常见错误是漏掉 header()、或者在输出前已有空格/echo/print 导致 header 发送失败。

• 必须在任何输出（包括空白符、BOM、echo、var_dump）之前调用 header('Content-Type: application/json; charset=utf-8')
• 推荐加 charset=utf-8，避免中文乱码；不加也不报错，但某些旧浏览器可能出问题
• json_encode($data, JSON_UNESCAPED_UNICODE | JSON_INVALID_UTF8_SUBSTITUTE) 能更好处理中文和非法 UTF-8 字符
• 别用 exit 或 die 替代 return —— 如果在函数里，直接 return 更安全，避免意外终止后续逻辑

Node.js Express 里用 res.json() 最省事，但要注意它自动设了 header

res.json() 内部已封装好 Content-Type 和 JSON.stringify()，90% 场景直接用就行。但它不是万能的：遇到循环引用对象会直接抛 TypeError，且无法控制缩进或编码细节。

• 等价于 res.set('Content-Type', 'application/json').send(JSON.stringify(...))
• 如果要自定义状态码，写成 res.status(400).json({ error: 'xxx' })，不要分开调用 status() 和 json()（虽然也能工作，但语义不清）
• 想加换行缩进调试？不能用 res.json()，得手动 res.set(...).send(JSON.stringify(data, null, 2))
• 注意 res.json(null) 会发 null 字符串，不是空响应；需要空响应请用 res.sendStatus(204)

Python Flask 的 jsonify() 和手动 json.dumps() 怎么选

jsonify() 是 Flask 提供的快捷封装，会自动设 Content-Type 并处理字典/列表；但只接受字典或可序列化对象，传入 datetime、自定义类会直接报错。

• 简单数据用 jsonify({'msg': 'ok'})，放心又简洁
• 含 datetime、Decimal 等类型？改用 json.dumps(..., default=str) + 手动 Response(..., mimetype='application/json')
• 别混用：jsonify() 返回的是 Response 对象，不能再链式调用 .headers.set()；如需额外 header，得用 make_response(jsonify(...))
• Flask 2.0+ 默认禁用 JSON_SORT_KEYS = True，但如果你依赖字段顺序（比如签名验签），仍建议显式设 app.config['JSON_SORT_KEYS'] = False

前端 fetch 接收时，response.json() 失败的三个典型原因

后端明明返回了 JSON 字符串，前端却提示 Unexpected end of JSON input 或 Invalid token —— 很少是语法问题，多是传输或 header 层面的隐性断层。

• 后端实际返回了 HTML 错误页（比如 500 页面），但 status 是 200，Content-Type 却没设对，导致前端当成 JSON 解析
• 响应体开头有 BOM（\uFEFF）、不可见空格或调试 var_dump() 输出残留在响应流中
• 用了 gzip 压缩但没正确设置 Content-Encoding: gzip，浏览器解压失败后把二进制当文本解析
• 检查方法：打开浏览器 Network 面板 → 点开请求 → 查看 Preview/Response 标签页，确认内容是否真为合法 JSON；再看 Headers 里的 Content-Type 是否为 application/json

最麻烦的不是不会写，而是 header 和 body 不同步、或者中间件悄悄改写了响应。上线前务必用 curl 或 Postman 直接测原始响应，别只信浏览器控制台里“看起来像 JSON”的那个预览。