序列化器不工作需先启用serializer组件：Symfony 6.2+默认未启用，须在framework.yaml中配置framework: serializer: true；启用后方可注入SerializerInterface或通过容器获取；未启用时调用直接抛ServiceNotFoundException。
序列化器不工作？先确认是否启用了 serializer 组件
Symfony 6.2+ 默认不启用 serializer，装了 symfony/framework-bundle 也不代表它就可用。没启用时调用 SerializerInterface 会直接报 ServiceNotFoundException。
检查 config/packages/framework.yaml 是否有这一行：
framework:
serializer: true
没有就加上；如果用了 API Platform，它会自动启用，但别默认假设它在那儿。
- 启用后，
serializer服务才可被注入或通过$container->get('serializer')获取 - 禁用状态下即使写了
use Symfony\Component\Serializer\Serializer，运行时照样失败 - 若项目已启用但序列化仍无效，优先查是否被其他 bundle（如旧版 FOSRestBundle）覆盖了服务定义
serialize() 和 deserialize() 的参数顺序和类型必须严格匹配
这两个方法看着简单，但参数错一位、类型差一点，就会静默返回空数组、null，或者抛出 NotNormalizableValueException —— 而不是你预期的 JSON 字符串。
典型写法：
$json = $serializer->serialize($user, 'json', [
'groups' => ['user:read']
]);
注意三点：
- 第一个参数必须是对象或数组，不能是字符串或数字；传
null会返回空字符串，不是错误 - 第二个参数是格式名，固定写
'json'（不是'JSON'或'application/json'） - 第三个参数是上下文数组，
groups是最常用项，但拼错成group或漏掉引号（如groups => user:read）会导致忽略序列化组
反序列化失败？大概率是类没配 @Groups 或构造函数参数不匹配
deserialize() 把 JSON 变回对象时，比序列化更脆弱。常见现象：返回一个空对象，或字段全为 null，控制台没报错，日志也没提示。
原因多集中在两处：
- 目标类没加
@Groups注解，或注解写在 private 属性上但没配set方法 —— 序列化器默认只读写 public 属性或通过 accessor（getter/setter）操作 - JSON 字段名和 PHP 属性名不一致，又没配
@SerializedName，比如 JSON 是"user_name"，PHP 属性是$username，不映射就丢数据 - 构造函数有必填参数（如
__construct(string $name)），但 JSON 没提供name字段，就会抛MissingConstructorArgumentsException
安全做法是显式声明构造器参数可为空，或用 ['allow_extra_attributes' => false] 上下文快速暴露字段缺失问题。
性能敏感场景下，避免在循环里反复调用 serialize()
单次序列化开销不大，但如果你在 Doctrine 查询结果遍历中对每个实体都调用 $serializer->serialize($entity, 'json')，会触发大量重复的元数据解析（比如从注解读 groups、找 getter 方法），实测 100 个对象可能慢 3–5 倍。
- 批量处理时，优先用
array_map()+ 单次序列化配置复用，或改用JsonEncoder+ObjectNormalizer手动组合，跳过框架层的上下文合并逻辑 - 高频 API 接口建议把序列化逻辑下沉到 DTO，并预编译为数组再
json_encode()，绕过serializer全流程 - 开发期可以加
dump($serializer->serialize($obj, 'json', ['debug' => true]))看生成的中间数组结构，比猜 JSON 输出更准
真正难调的不是语法，是上下文怎么传、注解往哪写、以及空值和缺失字段在哪个环节被吞掉了。
