php json_encode() 报“recursion detected”错误是因数组存在循环引用,如a对象引用b、b又引用a;需用json_last_error_msg()确认,根治应提前清理引用,而非依赖json_partial_output_on_error。

PHP json_encode() 报错 “Recursion detected” 怎么办
这不是数据太大,而是数组里有循环引用——比如对象 A 的属性指向了 B,B 又反过来存了 A 的引用。json_encode() 遇到这种结构会直接报错,不抛异常,只返回 false,还带个 E_WARNING。
- 先用
var_dump(json_last_error_msg())确认是不是这个错误 - 检查是否用了
self、$this或引用赋值(如&$obj)混进了要编码的数组 - 临时方案:用
json_encode($data, JSON_PARTIAL_OUTPUT_ON_ERROR)(PHP 7.3+),它会把无法序列化的项转成null,但别依赖它掩盖问题 - 根治办法:提前清理引用,比如用
array_map()+clone拆开对象,或用serialize()+ 正则过滤再反解(不推荐)
中文乱码、斜杠被转义、空格太多?看这三个参数组合
json_encode() 默认把中文转 Unicode(\u4f60),加斜杠转义引号,还压缩输出。实际接口开发中往往要反着来。
- 显示中文:必须加
JSON_UNESCAPED_UNICODE,否则前端看到一堆\u码点 - 保留换行缩进(调试用):加
JSON_PRETTY_PRINT,但上线环境建议关掉,体积大、解析慢 - 不转义斜杠(比如 URL 字段里的
https://):加JSON_UNESCAPED_SLASHES,否则变成https:\/\/ - 常见组合:
json_encode($arr, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES)
为什么 json_encode() 返回 null 却没报错?
返回 null 是最坑的情况——函数执行了,没警告,也没异常,但结果丢了。大概率是数据里混入了不能序列化的类型。
- 检查有没有
resource类型(比如fopen()返回的句柄) - 确认没有
SimpleXMLElement对象(XML 解析结果),它不能直出 JSON - 注意
NaN、INF、-INF在 PHP 中会被静默转成null - 用
json_last_error()判断:返回JSON_ERROR_INF_OR_NAN或JSON_ERROR_UNSUPPORTED_TYPE就对了
PHP 7.4+ 数组键名含数字字符串时,json_encode() 自动转对象?
是的。当数组键不是“连续数字索引”,又包含字符串数字(比如 ['0' => 'a', '1' => 'b']),json_encode() 会把它当成关联数组处理,最终输出为 JSON 对象而非数组。
立即学习“PHP免费学习笔记(深入)”;
- 这是 PHP 行为,不是 bug:只要键不是从
0开始的纯整数序列,就视为“非顺序索引数组” - 想强制输出 JSON 数组?先用
array_values()重排键名,但会丢掉原始键名语义 - 如果需要保留键名且确保是对象格式,不用干预;如果调用方强依赖数组格式(如 JS
Array.isArray()),就得在 PHP 层做结构适配
json_last_error() 和 json_last_error_msg() 才能揪出来,别只盯着返回值是不是 null。











