Symfony 7.1 Serializer：如何指定字段键类型以反序列化关联数组？

核心问题 #

Symfony Serializer默认将array<YourObject>类型解析为整数索引的数组，但你的场景需要接受字符串键（locale）的关联数组，因此触发类型不匹配错误。

解决方案 #

1. 使用#[Map]属性指定键类型（Symfony 7.1+推荐） #

在Catalog类的翻译字段上，用#[Map]注解明确声明键的类型为字符串，值为你的翻译对象类型（比如ProductTranslation）。

示例代码：

use Symfony\Component\Serializer\Annotation\Map;

class Catalog
{
    // 假设你的翻译对象是ProductTranslation
    #[Map(keyType: 'string', valueType: ProductTranslation::class)]
    private array $translations = [];

    // 其他属性和方法...
}

这个注解会告诉Serializer：这个数组是字符串键映射到ProductTranslation对象的关联数组，而非默认的整数索引数组。

2. 全局配置ArrayDenormalizer支持字符串键 #

如果需要全局生效，或者无法使用注解，可以在Serializer配置中调整ArrayDenormalizer的allow_string_keys选项。

在config/packages/serializer.yaml中添加：

framework:
    serializer:
        default_context:
            array_denormalizer:
                allow_string_keys: true

注意：此配置会影响所有数组类型的反序列化，若仅需针对特定字段，优先使用#[Map]注解。

3. 适配Doctrine Collection的序列化结果 #

因为输入来自带indexBy属性的Doctrine Collection，序列化后生成字符串键结构。若想直接反序列化为Doctrine集合而非普通数组：

• 将字段类型声明为Doctrine\Common\Collections\Collection而非array
• 配合#[Map]注解指定键类型（Symfony默认已集成Doctrine序列化支持，需确保依赖版本兼容）

示例：

use Doctrine\Common\Collections\Collection;
use Symfony\Component\Serializer\Annotation\Map;

class Catalog
{
    #[Map(keyType: 'string', valueType: ProductTranslation::class)]
    private Collection $translations;

    public function __construct()
    {
        $this->translations = new \Doctrine\Common\Collections\ArrayCollection();
    }

    // 其他方法...
}

验证测试 #

确保传入的payload结构与示例一致：

{
  "en": {
    "name": "Name of product"
  },
  "ar": {
    "name": "Name of product in arabic"
  }
}

此时Serializer会正确将每个字符串键（locale）对应的对象反序列化为ProductTranslation实例，并映射到Catalog的translations字段中。

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