如何为Symfony Serializer自定义归一化器传递字段上下文？

你的问题核心是自定义的EntityNormalizer没有处理字段级别的#[Context]注解解析逻辑——仅实现DenormalizerInterface的自定义Normalizer不会自动读取属性元数据中的注解上下文，必须手动对接元数据解析流程才能拿到这部分信息。

原因分析 #

Symfony Serializer的字段级#[Context]注解信息存储在属性元数据（PropertyMetadata）中，默认只有通过PropertyNormalizer或集成了元数据系统的Normalizer，才会自动将注解上下文合并到denormalize方法的$context参数里。你直接实现DenormalizerInterface，没有接入这套元数据解析流程，自然拿不到注解里的配置。

解决方法 #

方法一：通过PropertyNormalizer转发获取字段上下文 #

把你的EntityNormalizer设计为PropertyNormalizer的装饰器，借助它的元数据解析能力拿到字段级上下文：

1. 修改EntityNormalizer构造函数，注入依赖组件：

use Symfony\Component\Serializer\Normalizer\PropertyNormalizer;
use Symfony\Component\Serializer\Mapping\Factory\PropertyMetadataFactory;

class EntityNormalizer implements DenormalizerInterface
{
    public function __construct(
        private PropertyNormalizer $propertyNormalizer,
        private PropertyMetadataFactory $metadataFactory
    ) {}

    // 实现supportsDenormalization等必要方法...
}

2. 在denormalize方法中读取字段元数据：
   处理TariffDto的product字段时，主动提取该字段的#[Context]注解内容并合并到上下文：

public function denormalize($data, string $type, string $format = null, array $context = [])
{
    // 先通过PropertyNormalizer完成基础反序列化
    $object = $this->propertyNormalizer->denormalize($data, $type, $format, $context);

    // 获取TariffDto的product字段元数据
    $metadata = $this->metadataFactory->create($type);
    if ($metadata->hasProperty('product')) {
        $propertyMetadata = $metadata->getPropertyMetadata('product');
        // 提取字段的Context注解内容
        $fieldContext = $propertyMetadata->getContext() ?? [];
        // 合并到当前上下文（可按需选择覆盖或合并策略）
        $context = array_merge($context, $fieldContext);
        
        // 此时dump($context)就能看到EntityNormalizer::UNIQUE_ENTITY_FIELD的配置了
        dump($context);
    }

    // 你的自定义Entity处理逻辑...
    return $object;
}

方法二：手动配置元数据解析器 #

如果不想依赖PropertyNormalizer，可以手动创建元数据工厂来解析#[Context]注解：

1. 初始化注解加载器（框架外必须手动配置）：

use Symfony\Component\Serializer\Mapping\Factory\ClassMetadataFactory;
use Symfony\Component\Serializer\Mapping\Loader\AnnotationLoader;
use Doctrine\Common\Annotations\AnnotationReader;

$annotationReader = new AnnotationReader();
$classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader($annotationReader));

2. 在EntityNormalizer中注入ClassMetadataFactory并读取注解：

public function denormalize($data, string $type, string $format = null, array $context = [])
{
    $classMetadata = $this->classMetadataFactory->getMetadataFor($type);
    foreach ($classMetadata->getPropertiesMetadata() as $propertyMetadata) {
        if ($propertyMetadata->getName() === 'product') {
            $fieldContext = $propertyMetadata->getContext() ?? [];
            $context = array_merge($context, $fieldContext);
            break;
        }
    }

    // 后续自定义反序列化逻辑...
}

关键验证点 #

• 确认PropertyInfo组件配置正确，能正常读取类的属性注解信息；
• 检查Serializer实例创建时，是否将EntityNormalizer与元数据工厂正确关联；
• 若存在多个Normalizer，确保EntityNormalizer的优先级更高（通过getPriority()方法返回更大数值）。

内容的提问来源于stack exchange，提问作者Andrey Yanduganov