PHP返回JSON需设Content-Type头、确保数据UTF-8编码且可序列化、输出后立即exit；框架中优先用内置JSON响应方法。
PHP 用 json_encode() 返回 JSON 数据，但必须设对响应头
直接 echo json_encode($data) 不等于“返回 JSON”——浏览器或前端可能当纯文本解析，Content-Type 缺失是常见失败根源。
- 务必在
json_encode()前加header('Content-Type: application/json; charset=utf-8'); - 如果已输出过任何内容（空格、BOM、
echo、警告），header()会报Warning: Cannot modify header information，此时只能检查输出源头或启用输出缓冲（ob_start()） -
json_encode()默认不处理中文，遇到中文变\uXXXX：加JSON_UNESCAPED_UNICODE参数，如json_encode($data, JSON_UNESCAPED_UNICODE)
遇到 json_encode() 返回 null 或空字符串？查数据类型和编码
这不是函数坏了，是输入数据不满足 JSON 规范。最常踩的坑是混入了资源句柄、闭包、不可序列化对象，或字符串本身含非法 UTF-8 字节。
- 用
is_array()或is_object()确保输入是可遍历结构；var_dump(json_last_error_msg())能立刻定位错误类型 - 数据库查出的字段若含 GBK/latin1 编码内容，需先转 UTF-8：
mb_convert_encoding($str, 'UTF-8', 'GBK') - 时间戳建议转为字符串再输出，避免
DateTime对象直接进json_encode()（除非你显式实现了JsonSerializable）
API 接口里返回 JSON，别漏掉 HTTP 状态码
只返回 JSON 内容，不设状态码，会让前端难区分成功与失败。比如登录失败时返回 {"error": "invalid credentials"}，但状态码仍是 200，前端逻辑容易误判。
- 成功用
http_response_code(200)（默认已有，可省略） - 参数错误返回 400：
http_response_code(400); echo json_encode(['message' => 'Missing required field'], JSON_UNESCAPED_UNICODE); - 服务端错误统一用 500，但不要暴露堆栈——生产环境禁用
display_errors
用 exit 或 die 终止后续执行，避免意外输出
很多 PHP 脚本在 json_encode() 后还跟着其他逻辑（比如日志写入、重定向），导致 JSON 后面拼上 HTML 或空白，前端 JSON.parse() 直接报错。
立即学习“PHP免费学习笔记（深入）”；
- 输出 JSON 后立即加
exit;是简单有效的收尾方式 - 如果用了框架（如 Laravel、ThinkPHP），优先走框架的响应构造方法（如
response()->json()），它们自动处理头、状态码和终止 - 调试时用
var_dump()查看原始响应体（别只信浏览器开发者工具的“Preview”），确认没有隐藏字符或换行
真正麻烦的不是怎么调 json_encode()，而是它沉默地失败——返回 null、没报错、前端解析卡住。每次返回 JSON 前，默念三件事：头设了没、数据干净吗、后面还有输出吗。
