PHP json_encode循环引用为什么失败-php教程-PHP中文网

php 的 json_encode 遇到循环引用时返回 false 并触发 e_warning 警告，因 json 要求数据为有向无环图（dag），不支持对象/数组的循环嵌套；常见于父子关系、orm 双向关联等场景，需通过 unset、jsonserializable 或第三方序列化器手动破环。

php json_encode循环引用为什么失败

PHP 的 json_encode 在遇到循环引用（circular reference）时会直接失败，返回 false，并触发一个 E_WARNING 级别警告，例如：json_encode(): recursion detected。这是因为 JSON 格式本身不支持对象或数组之间的循环嵌套结构——它要求数据必须是**有向无环图（DAG）**，而循环引用打破了这一前提。

为什么 JSON 规范不允许循环引用

JSON 是一种纯数据交换格式，设计目标是轻量、可预测、跨语言兼容。它没有“引用地址”“内存指针”或“ID 标识”等机制来表达两个位置指向同一对象。如果允许循环，序列化就无法终止，解析器也无法确定何时停止展开。

比如 A→B→A 这样的结构，json_encode 会从 A 开始，进入 B，再试图回到 A，无限递归下去
PHP 内部在序列化时会维护一个已访问对象的栈，一旦发现重复入栈，就判定为 recursion 并中止

常见触发循环引用的场景

最典型的是对象之间互相持有对方的引用，尤其在 ORM 模型、树形结构或事件监听器中：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

父子关系未设好断开点（如 $parent->children = [$child]，同时 $child->parent = $parent）
Doctrine/ActiveRecord 类中启用了双向关联且未配置 @JsonIgnore 或序列化组
使用 __sleep 或 JsonSerializable 时逻辑出错，意外保留了闭环路径

如何安全处理循环引用

PHP 本身不提供自动破环选项，需手动干预。推荐几种实用方式：

提前解耦：序列化前用 unset() 或临时置空循环字段，例如 unset($obj->parent)
实现 JsonSerializable：在类中定义 jsonSerialize() 方法，只返回需要导出的字段，主动排除反向引用
使用第三方库：如 symfony/serializer 配合 MaxDepth 或 Ignore 注解，能自动截断深层引用
调试定位：开启 var_dump(json_last_error_msg()) 查看具体错误；用 xdebug 或 debug_zval_dump 检查引用计数和结构

一个小验证示例

运行以下代码就能复现错误：

$a = new stdClass();
$b = new stdClass();
$a->b = $b;
$b->a = $a;
var_dump(json_encode($a)); // bool(false)
echo json_last_error_msg(); // "recursion detected"

只要打破任一链接（如注释掉 $b->a = $a），就能正常输出。