Symfony Serializer专为DTO、数组等数据结构设计，不适用于Request/Response等运行时对象；需启用组件、正确注入SerializerInterface、指定'json'格式及groups上下文，并通过getter或@SerializedName控制字段映射。
Symfony Serializer 不是用来序列化 Request、Response 或控制器这类运行时对象的，它专为数据结构服务：DTO、数组、stdClass、纯 PHP 对象（POPO）。用错对象类型，轻则字段为空，重则直接报错或静默失败。
先确认组件已启用
Symfony 6.2+ 默认不启用 Serializer 组件。没启用就调用 SerializerInterface，会抛 ServiceNotFoundException。
- 打开 config/packages/framework.yaml
- 确保有这一行：
framework:<br> serializer: true
- 如果用了 API Platform，它会自动启用；但别默认假设它在那儿
序列化普通对象或数组
最常用场景：把 DTO 或关联数组转成 JSON。
- 注入 SerializerInterface（别 new Serializer 类）
- 第一个参数必须是对象或数组，不能是字符串、数字或 null
- 第二个参数固定写 'json'（不是 'JSON' 或 'application/json'）
- 第三个参数是上下文数组，groups 最常用，拼错成 group 或漏引号就失效
示例：
$json = $serializer->serialize($user, 'json', [
'groups' => ['user:read']
]);
让 DTO 字段不为空
默认只读 public 属性，或通过 getter（getXXX() / isXXX()）访问 private/protected 属性。
- 推荐加 getter 方法：
public function getName(): string { return $this->name; } - 或用注解控制字段名映射：
#[SerializedName('name')] private string $name; - 不建议全局开启 property 访问（破坏封装且易出问题）
处理 Doctrine 实体和关联嵌套
实体含循环引用（如 User ↔ Post），不加约束会报错或输出爆炸式数据。
- 用 @Groups 注解限定哪些字段参与序列化
- 用 @MaxDepth(1) 控制嵌套层级，避免无限展开
- 关联对象也需配组，比如 Post 的 id 只暴露给 user:read，内容只给 post:full
- DateTimeImmutable 需确保启用了 DateTimeNormalizer（默认已启用）
反序列化要注意什么
把 JSON 变回对象比序列化更敏感，常见“返回空对象”基本是这两类问题：
- 目标类没加 @Groups，或注解写在 private 属性上但没配套 setter
- JSON 字段名和 PHP 属性名不一致，又没配 @SerializedName（比如 JSON 是 user_name，PHP 是 $username）
- 构造函数有必填参数（如
__construct(string $name)），但 JSON 缺少对应字段，会抛 MissingConstructorArgumentsException
