必须显式配置 objectnormalizer 的 circularreferencehandler 回调，仅设 setcircularreferencelimit() 无效，因该方法仅计数不截断，遇循环仍无限递归；symfony serializer 不支持全局 yaml 配置循环策略。
必须显式配置 ObjectNormalizer 的 circularReferenceHandler 回调，仅设 setCircularReferenceLimit() 无效，且 Symfony Serializer 不支持全局 YAML 配置循环引用策略。
为什么 setCircularReferenceLimit() 不起作用
这个方法只在 ObjectNormalizer 内部做计数，但不会中断引用链；一旦遇到循环，它仍会继续尝试遍历，最终导致无限递归、页面卡死、无错误日志、var_dump() 失效。关键缺失的是“遇到循环时返回什么”的决策逻辑。
-
setCircularReferenceLimit(2)只是告诉 normalizer “最多进两层”，但不定义第三层该返回啥 - 没有
setCircularReferenceHandler()，normalizer 就不知道怎么“截断”，只能硬扛直到栈溢出或超时 - 这个限制对 Doctrine 实体的双向关联（如
User ↔ Post ↔ User）完全无效，因为引用发生在属性层级，不是嵌套深度
必须手动组装 Serializer 实例并注入 handler
不能依赖框架默认注册的 serializer 服务——它没配 circularReferenceHandler。你得自己 new 一个，并确保 ObjectNormalizer 是唯一或优先启用的 normalizer。
- 在控制器、命令或服务中显式构造：
$normalizer = new ObjectNormalizer(); $normalizer->setCircularReferenceHandler(fn($object) => $object->getId() ?? 'circular-ref'); $serializer = new Serializer([$normalizer], [new JsonEncoder()]);
- 若用
DateTimeNormalizer或GetSetMethodNormalizer，需把它们和ObjectNormalizer一起传入，顺序影响行为（ObjectNormalizer应靠前） - 不要在多个地方重复写这段逻辑：封装成工厂类或自定义服务，比如
App\Serializer\CircularAwareSerializer
Doctrine 实体序列化时的典型陷阱
实体自带 PersistentCollection 和反向引用（inversedBy），极易触发循环，且错误表现隐蔽：页面白屏、CPU 拉满、无异常抛出。
- 别依赖
@Groups单独解决循环——它只控制字段是否出现，不切断引用路径 - 集合属性（如
$posts）若内部持有父对象（$post->getUser()返回当前User），必须用@Ignore或@MaxDepth(1)显式排除 - 调试时用
dump($entity)前先试VarCloner::create()->cloneVar($entity)，它自带循环检测，比原生var_dump安全 - 检查
mappedBy/inversedBy是否配对正确：运行php bin/console debug:doctrine看映射报告里的 warning
最易被忽略的一点：handler 回调函数里不能调用可能触发数据库查询的方法（比如未初始化的 $object->getSomething()），否则会引发 N+1 或死锁；一律用已加载字段（getId()、getUuid()）或硬编码占位符。
