绝大多数时候 json_encode() 返回空或 null 是因数据含不可序列化值或 utf- 8 不合法；需立即用 json_last_error() 定位，检查资源、编码、数据库字符集及输出干扰。
php json_encode() 返回空字符串或 null 怎么快速定位
绝大多数时候不是数据“不对”，而是数据里混进了不能 JSON 序列化的值，比如资源句柄、闭包、SimpleXML 对象，或者中文字符被意外截断导致 UTF-8 不合法。
-
json_last_error()和json_last_error_msg()必须紧跟在json_encode()后立刻调用，中间不能夹任何其他函数（包括var_dump()） - 对要编码的变量先做
var_dump(gettype($data), is_array($data), is_object($data))，确认不是资源型（resource）或未实现JsonSerializable的自定义对象 - 中文出问题？用
mb_check_encoding($data, 'UTF-8')检查，非 UTF-8 字符串先mb_convert_encoding($data, 'UTF-8', 'GBK') - 如果数据来自数据库，PDO 默认返回
stdClass对象，json_encode()支持，但若字段含NULL或0x00字节仍会失败
如何安全地把 MySQL 查询结果转成 JSON 并避免乱码
直接 json_encode(mysqli_fetch_all($result, MYSQLI_ASSOC)) 很危险：MySQL 连接字符集没设对，JSON 里就会出现 uFFFD 替换符，前端解析不报错但内容已损毁。
- 连接后立即执行
mysqli_set_charset($conn, 'utf8mb4')（注意是utf8mb4，不是utf8） - 查询前加
SET NAMES utf8mb4双保险 - 字段含 emoji 或四字节 Unicode？确保表和字段的 COLLATION 是
utf8mb4_unicode_ci或更高 - 用
PDO::FETCH_ASSOC而非PDO::FETCH_OBJ，避免对象属性名带不可见字符
前端收到 JSON 却解析失败，后端该检查哪些 header 和输出干扰
浏览器控制台显示 SyntaxError: Unexpected token，往往不是 JSON 本身错，而是 PHP 输出了额外字符——比如 BOM、空白、echo 漏删、错误警告混入响应体。
- 必须设置
header('Content-Type: application/json; charset=utf-8')，缺charset参数时部分安卓 WebView 会默认用 ISO-8859-1 解码 - 开启输出缓冲：
ob_start()→ 编码 →ob_clean()→echo $json，防止意外输出 - 禁用所有错误显示：
ini_set('display_errors', '0')，开发环境用日志记录而非屏幕输出 - 用
curl -i直接看原始响应头 +body，确认开头是不是纯{或[，有没有空行或 HTML 标签
需要兼容老版本 PHP（如 5.3）时怎么处理 JSON_UNESCAPED_UNICODE 不可用
PHP 5.4 才支持 JSON_UNESCAPED_UNICODE，旧项目里中文全变成 u4f60u597d，前端显示正常但调试困难、日志难读。
立即学习 “PHP 免费学习笔记（深入）”；
- 别自己写正则替换
u……，容易误伤 JSON 字符串里的合法转义 - 用
iconv('UCS-2BE', 'UTF-8', pack('H4', $hex))手动解码不现实，维护成本高 - 稳妥做法：升级到 PHP 7.0+（官方已停止维护 5.6），或至少用
json_encode($data, JSON_UNESCAPED_SLASHES)减少干扰 - 实在无法升级？在 Nginx/Apache 层加
add_header Content-Type "application/json; charset=utf-8";，至少保证传输正确
真正卡住人的从来不是 json_encode() 本身，而是它前面那十几行你没盯住的数据库连接、字符集切换、错误抑制和输出控制——漏掉任意一环，JSON 看似生成了，实际已经悄悄损坏。
