Symfony Serializer 仅安全序列化普通 PHP 数据结构（如数组、stdClass、DTO 类），不支持 Symfony 核心对象（如 Request、Response）或含循环引用/资源句柄的对象；DTO 需提供 getter 或注解配置，Doctrine 实体需用 @Groups 和 @MaxDepth 控制嵌套。
直接说结论：Symfony Serializer 本身不序列化 Symfony 对象（比如 Request、Response、Controller），它只处理**普通 PHP 数据结构**（数组、stdClass、DTO 类等）；试图传入框架核心对象会报错或返回空/意外结果。
Serializer 序列化什么对象才安全？
它设计目标是“数据传输对象”（DTO）或纯数据类，不是运行时服务对象。常见误用是把 $this、$request、$entityManager 直接丢给 serialize() —— 这些含循环引用、闭包、资源句柄，Serializer 会抛出 SerializationFailedException 或静默失败。
- ✅ 安全：自定义 DTO 类（无构造依赖、无魔术方法副作用）、
array、stdClass、POPO（Plain Old PHP Object） - ❌ 危险：任何 Symfony 组件实例（
Request、Router、CacheItem）、Doctrine 实体（除非显式配置@Groups和@MaxDepth） - ⚠️ 注意：
DateTimeInterface默认可序列化，但DateTimeImmutable需确保启用DateTimeNormalizer
怎么正确配置并使用 Serializer？
默认安装 Symfony 后，serializer 服务已注册，但需确认是否启用了关键 normalizer。常见漏配导致 Call to undefined method …::getClassName() 等错误。
- 检查
config/packages/serializer.yaml是否包含：serializer: enabled: true default_context: serialize_nulls: false - 确保
symfony/serializer-pack已安装（含ObjectNormalizer、ArrayDenormalizer等） - 使用时优先注入
SerializerInterface，而非Serializer类（避免绕过 DI 配置） - 简单示例：
$data = ['name' => 'Alice', 'score' => 95]; $json = $serializer->serialize($data, 'json');
为什么 DTO 类序列化后字段为空？
默认情况下，ObjectNormalizer 只读取 public 属性，或通过 getter 方法（getXXX()、isXXX()）。private/protected 属性 + 无 getter = 被忽略。
立即学习“PHP免费学习笔记（深入）”；
- 方案一：加 getter（推荐）
public function getName(): string { return $this->name; } - 方案二：用注解开启属性访问：
use Symfony\Component\Serializer\Annotation\SerializedName; // ... #[SerializedName('name')] private string $name; - 方案三：全局配置允许访问 private 属性（不推荐，破坏封装）：
object_normalizer: enable_max_depth: true # ⚠️ 不要设 access_type: property
序列化 Doctrine 实体时循环引用怎么办？
比如 User → Post → User，不处理会爆栈或报 CircularReferenceException。
- 必须启用
AbstractObjectNormalizer::CIRCULAR_REFERENCE_HANDLER上下文选项 - 在调用时传入回调：
$context = [ AbstractObjectNormalizer::CIRCULAR_REFERENCE_HANDLER => fn ($obj) => $obj->getId() ]; $serializer->serialize($user, 'json', $context); - 更稳妥做法：用
@Groups显式控制字段，并配合@MaxDepth(1)限制嵌套深度
真正难的不是调用 serialize()，而是判断「这个对象到底能不能被安全序列化」——别信 IDE 自动补全，先看类定义里有没有 __sleep、__serialize、循环引用、未初始化的 lazy 属性，再决定要不要扔给 Serializer。
