必须用header('Content-Type: application/json; charset=utf-8')设置响应头，且需在任何输出前调用；json_encode()应至少启用JSON_UNESCAPED_UNICODE和JSON_THROW_ON_ERROR；注意BOM、空格、服务器缓冲及CDN干扰。
PHP设置Content-Type为application/json必须用header()
不设这个头，前端拿到的永远是text/html或text/plain，哪怕内容是合法JSON，fetch().json()也会报Unexpected token错误。
关键不是“输出JSON”，而是让浏览器/客户端明确知道这是JSON数据：
-
header('Content-Type: application/json; charset=utf-8')是唯一可靠写法； - 别用
header('Content-Type: text/json')——已废弃，现代浏览器不认； - 别漏掉
charset=utf-8，否则中文字段可能变\uXXXX或乱码； - 必须在任何输出（包括空格、BOM、
echo）之前调用，否则报Warning: Cannot modify header information。
JSON输出前必须确保没有意外输出
PHP对HTTP头极其敏感：哪怕开头多一个空格、UTF-8 BOM、或提前echo ''，header()就会失效。
常见踩坑点：
立即学习“PHP免费学习笔记（深入）”；
- 文件开头有BOM（尤其Windows编辑器保存时默认加BOM），用
hexdump -C yourfile.php | head查，开头出现ef bb bf就是BOM； -
require或include的文件末尾有空行或空格； - 使用
var_dump()、print_r()调试后忘了删； - 框架或Composer自动加载触发了日志、警告、Notice，哪怕没显示也会冲掉header。
最稳做法：ob_start()包住整个逻辑，最后ob_end_clean()清空缓冲再echo json_encode(...)，但仅限调试阶段——线上应直接修复源头输出。
json_encode()的几个关键参数不能省
裸用json_encode($data)在生产环境大概率出问题：
- 含中文时不用
JSON_UNESCAPED_UNICODE，中文全变\u676e，前端难读难调试； - 含
NaN、INF或资源句柄（如mysqli连接）会返回false，且不报错——得加JSON_THROW_ON_ERROR； - 深层嵌套数组或对象超深时（默认128层），需显式传
JSON_DEPTH，否则截断不提示； - 时间戳、
DateTime对象默认不序列化，得自己转成字符串，或用JSON_UNESCAPED_SLASHES避免\/。
推荐写法：json_encode($data, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR)。
Apache/Nginx下注意输出缓冲和gzip干扰
即使PHP代码完全正确，服务器配置也可能破坏JSON响应：
- Apache开启
mod_deflate但没配AddOutputFilterByType DEFLATE application/json，JSON不会被压缩，但更糟的是某些旧版本会直接禁用压缩导致响应头错乱； - Nginx默认
gzip_types不含application/json，要手动加上，否则大JSON响应慢得明显； - PHP启用了
output_buffering = 4096（默认），小JSON可能卡在缓冲区不发，加flush()没用，得关掉或设为Off； - 某些CDN或反向代理（如Cloudflare）会重写
Content-Type，测试时绕过CDN直连PHP确认。
最简验证方式：用curl -I http://yoursite/api.php看返回头里Content-Type是否准确，且无X-Powered-By等干扰字段泄露细节。
