如何用Symfony的#[MapRequestPayload]映射嵌套DTO的PUT/POST请求

出现"details: This value should be of type unknown"错误，主要是因为类型信息缺失、字段映射不匹配以及类型声明不一致导致的，以下是具体修复步骤：

1. 完善SearchResult的集合类型信息 #

Symfony的MapRequestPayload依赖明确的类型提示来解析嵌套集合，仅用PHPDoc注释不足以让组件识别集合的元素类型。

方案一：PHP 8.1+ 泛型声明（推荐） #

直接在属性和方法中添加泛型类型标注：

use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;

class SearchResult
{
    private Collection<int, Details> $details;

    public function __construct() {
        $this->details = new ArrayCollection();
    }

    public function getDetails(): Collection<int, Details>
    {
        return $this->details;
    }

    public function setDetails(Collection<int, Details> $details): SearchResult
    {
        $this->details = $details;
        return $this;
    }

    public function addDetails(Details $details): self
    {
        if (!$this->details->contains($details)) {
            $this->details[] = $details;
        }
        return $this;
    }
}

方案二：低PHP版本兼容（用Symfony注解） #

如果PHP版本低于8.1，使用Symfony的#[Collection]注解指定集合元素类型：

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

class SearchResult
{
    /**
     * @var Collection<int, Details>
     * @Collection(targetClass=Details::class)
     */
    private Collection $details;

    // 其余方法保持不变
}

2. 修复Details类的类型不一致问题 #

Details类中getTicker()返回?string，但setTicker()参数要求string（非空），这种类型不匹配会导致映射验证失败，需统一类型：

class Details
{
    private string $name;
    // 如果ticker不允许为null，保持类型一致
    private string $ticker;

    public function getTicker(): string
    {
        return $this->ticker;
    }

    public function setTicker(string $ticker): Details
    {
        $this->ticker = $ticker;
        return $this;
    }

    // 其余属性方法保持不变
}

若允许ticker为null，则修改属性和方法的类型为?string：

private ?string $ticker = null;

public function getTicker(): ?string
{
    return $this->ticker;
}

public function setTicker(?string $ticker): Details
{
    $this->ticker = $ticker;
    return $this;
}

3. 处理蛇形命名与驼峰命名的映射 #

请求中的字段使用蛇形命名（如homepage_url），但DTO属性是驼峰命名（homepageUrl），需配置自动转换：

全局配置（推荐） #

在config/packages/framework.yaml中启用驼峰转蛇形的命名转换器：

framework:
    serializer:
        name_converter: 'serializer.name_converter.camel_case_to_snake_case'

局部注解配置 #

也可以在DTO属性上单独添加#[SerializedName]注解：

use Symfony\Component\Serializer\Annotation\SerializedName;

class Details
{
    private string $name;
    private string $ticker;

    #[SerializedName('homepage_url')]
    private ?string $homepageUrl = null;

    #[SerializedName('sic_code')]
    private ?int $sicCode = null;

    #[SerializedName('sic_description')]
    private ?string $sicDescription = null;

    // 其余属性和方法保持不变
}

4. 确认依赖组件已启用 #

确保serializer和validator组件在config/bundles.php中启用：

return [
    // 其他Bundle...
    Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true],
    Symfony\Bundle\ValidatorBundle\ValidatorBundle::class => ['all' => true],
];

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