json_encode在PHP 8.1中遇循环引用会返回false并警告，需主动检测断开或替换；推荐用symfony/serializer等库处理，或从设计上规避（如ID关联替代嵌套）。
PHP 8.1 中，当数组（或对象）存在循环引用时，json_encode 会直接失败并返回 false，同时触发警告："Circular reference detected"。这不是 bug，而是 JSON 标准本身不支持循环结构——JSON 是一种纯数据交换格式，没有指针或引用概念。因此，处理的关键不是“绕过限制”，而是**主动检测、断开或替换循环引用**。
手动检测并移除循环引用
利用 spl_object_hash（对象）或递归遍历 + 引用标识（数组），在序列化前预处理数据。对数组循环引用，可借助引用计数或已访问容器判断：
- 用一个全局数组（如
$seen = []）记录已遍历的数组 ID（可用spl_object_hash($arr)获取，但注意普通数组无对象哈希，需用&$arr+uniqid()或debug_zval_dump辅助识别） - 更稳妥的做法：将待处理数据先转换为对象（如
(object)$arr），再用标准对象循环检测逻辑；或使用RecursiveArrayIterator配合自定义递归深度控制 - 发现重复引用时，用占位符替代，例如
'__circular_ref__' => true或具体路径标识（如'#ref:users.0.address'）
使用第三方库自动处理（推荐）
手动处理易出错且难以覆盖嵌套对象+数组混合场景。推荐使用成熟库：
-
symfony/serializer：支持
CircularReferenceHandler，可配置回调返回替代值（如 ID、空数组或字符串提示） -
webmozart/json：轻量，提供
JsonEncoder并内置循环检测与替换策略 - 若项目已用 Laravel，
Illuminate\Support\Arr::jsonSerialize可配合自定义JsonSerializable实现
示例（symfony/serializer）：
立即学习“PHP免费学习笔记（深入）”；
use Symfony\Component\Serializer\Serializer;
use Symfony\Component\Serializer\Encoder\JsonEncoder;
use Symfony\Component\Serializer\Normalizer\ArrayDenormalizer;
use Symfony\Component\Serializer\Normalizer\ObjectNormalizer;
$encoder = new JsonEncoder();
$encoder->setCircularReferenceHandler(function ($object) {
return ['__circular' => true, 'id' => spl_object_hash($object)];
});
$serializer = new Serializer([new ObjectNormalizer(), new ArrayDenormalizer()], [$encoder]);
$json = $serializer->serialize($data, 'json');
改用其他序列化方式（非 JSON 场景）
如果目标不是生成标准 JSON（比如仅用于 PHP 内部缓存或调试），可换用支持引用的格式：
-
serialize() / unserialize()：原生支持循环引用，但结果不可读、不跨语言、有反序列化风险 -
igbinary_serialize()（需扩展）：更紧凑高效，同样支持引用 -
msgpack_pack()（需 msgpack 扩展）：二进制格式，支持循环，性能好，有跨语言支持
注意：这些方案不能替代 json_encode 在 API 响应、前端交互等场景的作用。
设计层面规避循环引用
最根本的解法是从数据结构设计入手：
- 避免在 DTO、API 响应数组中直接嵌套完整关联对象，改用 ID 关联（如
'author_id' => 123而非'author' => [...]） - 使用“扁平化”结构：把嵌套关系转为独立键值对，配合元数据说明关系（适合复杂图结构）
- 在 ORM 层（如 Doctrine、Eloquent）启用
cascade和fetch策略控制加载深度，避免意外带出双向关联
