symfony 6.2+需手动启用serializer组件，配置framework.yaml中framework: serializer: true；序列化需严格匹配参数顺序与类型，反序列化易因注解、命名或构造函数导致静默失败。
确认 serializer 组件已启用
Symfony 6.2+ 默认不启用 serializer 组件，即使装了 symfony/framework-bundle 也不代表它可用。未启用时注入 SerializerInterface 会直接抛 ServiceNotFoundException。
检查 config/packages/framework.yaml 是否包含：
framework:
serializer: true
- 没有就加上；API Platform 会自动启用，但别默认假设它在那儿
- 启用后才能通过构造函数注入
SerializerInterface或调用$container->get('serializer') - 若已启用却仍失败，优先排查是否被旧版
FOSRestBundle等覆盖了服务定义
基础序列化：对象 → JSON 和 XML
serialize() 方法参数顺序和类型必须严格匹配，错一位就可能静默返回空字符串或 null，而不是你想要的 JSON/XML。
典型写法：
$json = $serializer->serialize($user, 'json', [
'groups' => ['user:read']
]);
$xml = $serializer->serialize($user, 'xml', [
'groups' => ['user:read']
]);
- 第一个参数必须是对象或数组；传
null会返回空字符串，不是异常 - 第二个参数是格式名，固定写
'json'或'xml'（不是'JSON'、'application/json'） - 第三个参数是上下文数组：
groups最常用，但拼错成group或漏引号（如groups => user:read）会导致忽略组配置
XML 序列化需额外安装依赖：composer require symfony/xml-serializer，否则会报 UnsupportedFormatException。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
控制器中更简洁的 JSON 输出方式
在控制器里，不用手动调用 serialize()，直接用 $this->json() 更安全高效：
#[Route('/user/{id}', name: 'user_show')]
public function show(User $user): Response
{
return $this->json($user, 200, [], ['groups' => 'user:read']);
}
- 该方法底层调用
Serializer并自动设置Content-Type: application/json - 支持上下文参数（如
groups），但不支持 XML ——$this->json()只处理 JSON - 若需 XML 响应，仍得手动
serialize(..., 'xml')+new Response($xml, 200, ['Content-Type' => 'application/xml'])
反序列化时字段映射和构造函数陷阱
把 JSON/XML 转回对象（deserialize()）比序列化更脆弱，常见现象是返回空对象或字段全为 null，还不报错。
关键检查点：
- 目标类是否加了
@Groups注解？注解写在private属性上但没配setter方法，ObjectNormalizer默认跳过 - JSON 字段名（如
"user_name"）和 PHP 属性名（如$userName）不一致，又没加@SerializedName("user_name")，字段就丢了 - 构造函数有必填参数（如
__construct(string $name)），但输入 JSON 没提供name字段，会抛MissingConstructorArgumentsException
XML 反序列化对命名空间、根节点名更敏感，建议先用 json 验证逻辑，再切到 xml 补充配置。
