在 symfony 7.0 中启用序列化器需手动配置 framework.yaml 启用 serializer 组件，推荐通过依赖注入获取 serializerinterface 实例，序列化时指定 'json' 格式及 groups，反序列化支持转类实例或数组，处理循环引用需配置 circular_reference_handler。
在 Symfony 7.0 中创建序列化器用于 JSON 转换，必须先确认组件已启用且依赖完整，否则注入 SerializerInterface 会直接失败，控制器跑不起来。
启用 serializer 组件
打开 config/packages/framework.yaml，检查是否存在以下配置：
framework:
serializer: true
如果没有，手动添加并保存。Symfony 7.0 默认仍不启用该组件，即使装了 framework-bundle 也不代表它就可用。
【未启用时调用 $container->get('serializer') 或注入 SerializerInterface 会抛 ServiceNotFoundException】
获取序列化器实例
方法一：通过依赖注入（推荐）
在控制器或服务中声明类型提示：
use Symfony\Component\Serializer\SerializerInterface;
然后在构造函数或方法参数中直接写入：
public function __invoke(SerializerInterface $serializer)
方法二：从容器手动获取（仅限测试或特殊场景）
在控制器中写：
$serializer = $this->container->get('serializer');
注意：$this->container 必须是 ContainerInterface 实例，且不能在无容器上下文（如纯命令行类）中直接使用。
序列化对象为 JSON 字符串
第一步：确保目标对象可序列化——类属性需有 getter 方法，或加 #[Groups] 注解标记可序列化字段。
第二步：调用 serialize() 方法，传入三个参数：
$json = $serializer->serialize($user, 'json', [
'groups' => ['user:read']
]);
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
注意：第二个参数必须是小写 'json'，写成 'JSON' 或 'application/json' 会导致静默返回空字符串；第三个参数中 groups 键名不能拼错，也不能漏掉引号。
第三步：若要返回 HTTP 响应，直接包装为 JsonResponse：
return new JsonResponse($json, 200, [], true);
最后一个布尔参数 true 表示 $json 已是字符串，无需再 encode。
反序列化 JSON 字符串为对象
方法一：转为指定类实例
$user = $serializer->deserialize($jsonString, User::class, 'json');
这要求 User 类有 public 属性或配套的 setter 方法；若 JSON 字段名与 PHP 属性名不一致（如 JSON 是 user_name，PHP 是 $userName），必须加 #[SerializedName('user_name')] 注解。
方法二：转为关联数组（适合结构不固定或 DTO 未定义时）
$data = $serializer->deserialize($jsonString, 'array', 'json');
这个操作不校验结构，但能快速提取原始数据，后续可手动映射到对象或验证。
处理 Doctrine 实体的循环引用
当序列化含双向关联的实体（如 User ↔ Post）时，默认会触发无限递归，最终报 500 错误或内存溢出。
解决方案是在序列化上下文中加入循环引用处理器：
$json = $serializer->serialize($user, 'json', [
'circular_reference_handler' => fn($object) => $object->getId(),
'groups' => ['user:read']
]);
这会让序列化器遇到重复对象时只输出 ID，而不是尝试展开整个对象树。
