json_encode无法处理数组中的循环引用，是因为PHP在深度遍历中检测到同一内存地址被重复访问，为防止无限递归和栈溢出而主动中止并返回false，这是符合JSON标准的强制安全限制。
json_encode 无法处理数组中的循环引用，是因为它在内部递归遍历时会检测到同一变量被重复访问，为防止无限循环和栈溢出，PHP 主动中止编码并返回 false。
循环引用触发安全保护机制
PHP 的 json_encode 实现对数据结构做深度遍历。一旦发现某个数组元素或对象属性指向已进入遍历路径的同一内存地址（例如 $a['ref'] = &$a），就会判定为循环依赖。这不是 bug，而是强制性的安全限制。- JSON 标准本身不支持引用语法，无法表达“这个值等于前面那个”
- 无限递归会导致内存耗尽或进程崩溃
- PHP 选择立即失败，而非静默截断或错误输出
典型循环结构示例
```php $a = ['name' => 'test']; $a['self'] = &$a; // 自引用 echo json_encode($a); // 返回 false ```类似情况还包括对象属性互相持有、多维数组嵌套指向父级、闭包捕获自身等。
如何确认是循环引用导致失败
不要只检查返回值是否为 false 或 null： - 紧跟调用 json_last_error_msg()，若输出 "Recursion detected" 就是明确信号 - 用 var_dump($data) 或 print_r($data) 观察是否有 &符号或 "Circular reference" 提示 - 对复杂对象，可先尝试 serialize()，它支持引用序列化，能辅助定位循环点可行的应对方式
- 在编码前用自定义函数扫描并断开引用，比如将循环位置替换为 null 或字符串标识符 - 实现 JsonSerializable 接口，在 jsonSerialize() 方法中主动排除循环字段 - 使用 JSON_PARTIAL_OUTPUT_ON_ERROR（PHP ≥7.3）获得部分有效 JSON，便于调试 - 对必须保留关系的数据，改用 serialize() + base64 编码，或选型更灵活的序列化方案如 msgpack不复杂但容易忽略。
