json_encode()返回null最常见原因是含不可序列化值（如资源、循环引用）或非UTF-8字符串；应先用json_last_error_msg()定位错误，再统一编码、过滤非法类型。
json_encode() 为什么返回 null 或空字符串
最常见原因是数组里含有无法序列化的值，比如资源类型（mysqli 对象、fopen() 返回的句柄）、NaN、INF，或包含循环引用的对象。PHP 不会报错，而是静默失败并返回 null。
- 用
json_last_error()和json_last_error_msg()立即检查错误，例如：$json = json_encode($data);<br>if ($json === null) {<br> echo json_last_error_msg(); // 如 "Type is not supported"</br>} - 对不确定结构的数据，先用
array_walk_recursive()过滤掉资源、NaN等非法值，或用is_scalar()+is_null()做预检 - UTF-8 编码不是可选——所有字符串必须是 UTF-8。含 GBK/ISO-8859-1 的字符串会直接导致
json_encode()返回null，可用mb_convert_encoding($str, 'UTF-8', 'auto')统一转换
常用参数组合与实际效果差异
json_encode() 的第二个参数是位掩码，不同组合直接影响输出体积、可读性和兼容性。
-
JSON_UNESCAPED_UNICODE：保留中文等 Unicode 字符原样（如"姓名": "张三"），不转成\u5f20\u4e09；不加它则默认转义，前端解析无影响，但日志或调试时难读 -
JSON_PRETTY_PRINT：换行缩进，仅用于调试或 API 响应开发阶段；上线务必关闭，否则增加传输体积且部分老客户端（如 IE8 的 JSON 解析器）不兼容 -
JSON_NUMERIC_CHECK：把看起来像数字的字符串（如"123"、"0123"）转为数字类型；注意："1e5"会被转成浮点数，可能丢失精度；"0123"变成123（八进制前缀丢失） - 组合示例：
json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)
处理关联数组和索引数组的隐式行为
PHP 没有“关联数组”和“索引数组”的 JSON 类型对应，json_encode() 全靠键名是否为连续整数来判断输出对象 {} 还是数组 []。
- 以下被当成对象（即使全是数字键）：
['name' => 'a', 0 => 'b']→{"name":"a","0":"b"}（因为键不连续） - 以下被当成数组：
[0 => 'a', 1 => 'b', 2 => 'c']→["a","b","c"] - 若想强制输出对象，哪怕内容是纯数字索引，可先用
(object)$arr转型，或在调用时加JSON_FORCE_OBJECT标志 - 注意：
JSON_FORCE_OBJECT对null、数字、字符串等标量无效，只影响数组
大数组性能与内存问题怎么破
当数组嵌套深、元素多（尤其含大量字符串）时，json_encode() 可能卡顿或触发 memory_limit 错误，这不是 bug，是 PHP 复制+编码过程的必然开销。
立即学习“PHP免费学习笔记（深入）”；
- 避免在循环中反复调用
json_encode()；合并数据后再一次性编码 - 对超大日志类数组，考虑流式输出：用
json_encode()分段处理子数组，配合fwrite()直接写文件，而不是拼成完整字符串再存 - PHP 7.3+ 支持
JSON_INVALID_UTF8_IGNORE和JSON_INVALID_UTF8_SUBSTITUTE，可在含非法 UTF-8 字节时跳过或替换，避免因单个脏数据导致整个编码失败 - 如果只是临时调试，用
var_export($arr, true)替代——它不生成 JSON，但可读性接近，且不依赖编码合法性
json_encode() 返回 null 却没查 json_last_error_msg()，这比参数选错更常导致线上故障。 
