{"summary":"必须在任何输出前设置Content-Type为application/json；PHP需header()+json_encode()，Node.js用res.json()，Flask用jsonify()或json.dumps()+Response；前端fetch.json()失败多因header错、BOM/空格、HTML错误页混入。"}
直接返回 JSON 数据，Content-Type 必须设为 application/json，否则前端 fetch().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”的那个预览。
