如何控制序列化器组上下文仅应用于指定嵌套资源

我有四个类：MainEntity、SubEntityA、SubEntityB和CommonMiniEntity。类结构及属性分组配置如下：

MainEntity
    SubEntityA
        CommonMiniEntity
            - propertyA #[Groups(['normal'])]
            - propertyB #[Groups(['extended'])]
    SubEntityB
        CommonMiniEntity
            - propertyA #[Groups(['normal'])]
            - propertyB #[Groups(['extended'])]

需求是：序列化MainEntity时，为两个子资源都应用normal分组，仅为SubEntityB额外应用extended分组，最终得到如下JSON结果：

{
    "subEntityA" : {
        "propertyA": 111
    },
    "subEntityB" : {
        "propertyA": 222,
        "propertyB": 333
    }
}

针对这类精细化的序列化分组控制，核心是在父实体的子属性上绑定差异化的分组集合，让嵌套实体继承对应分组，从而精准控制哪些属性被序列化。以下以适配#[Groups]注解的Symfony序列化器为例：

1. 给MainEntity的子属性配置专属分组 #

修改MainEntity的注解，为不同子实体分配不同的分组组合：

use Symfony\Component\Serializer\Annotation\Groups;

class MainEntity
{
    // 仅绑定基础分组，对应subEntityA的normal需求
    #[Groups(['main_base'])]
    private SubEntityA $subEntityA;

    // 同时绑定基础+扩展分组，对应subEntityB的normal+extended需求
    #[Groups(['main_base', 'main_extended'])]
    private SubEntityB $subEntityB;

    // 省略getter、setter方法
}

2. 让子实体关联父级分组 #

调整SubEntityA和SubEntityB的CommonMiniEntity属性注解，绑定对应父级分组，确保分组能传递到嵌套属性：

class SubEntityA
{
    #[Groups(['main_base'])]
    private CommonMiniEntity $commonMiniEntity;

    // 省略getter、setter方法
}

class SubEntityB
{
    #[Groups(['main_base', 'main_extended'])]
    private CommonMiniEntity $commonMiniEntity;

    // 省略getter、setter方法
}

3. 映射原有分组到新分组（可选） #

如果需要保留原有normal/extended分组的复用性，可以修改CommonMiniEntity的注解，让新分组与原有分组关联：

class CommonMiniEntity
{
    #[Groups(['normal', 'main_base'])]
    private int $propertyA;

    #[Groups(['extended', 'main_extended'])]
    private int $propertyB;

    // 省略getter、setter方法
}

4. 执行序列化 #

序列化时传入main_base和main_extended两个分组即可：

use Symfony\Component\Serializer\SerializerInterface;

// 假设$serializer是已注入的SerializerInterface实例
$result = $serializer->serialize(
    $yourMainEntityInstance,
    'json',
    ['groups' => ['main_base', 'main_extended']]
);

替代方案：动态上下文控制 #

如果不想修改实体注解，也可以通过自定义序列化上下文处理器，在序列化时针对特定属性动态添加分组，但这种方式代码复杂度更高，不如注解方式直观易维护。

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