API Platform装饰ItemNormalizer引发非资源类错误问题排查

出现这个错误的核心原因是装饰后的Normalizer错误地让ItemNormalizer处理了非API Platform资源类的FileMultipleResponseDto，即使你没添加自定义逻辑，也可能因为装饰器的实现或配置问题导致原服务的判断逻辑失效。

1. 检查装饰器代码的正确性 #

确保你的装饰器完全转发所有方法调用给原服务，尤其是以下关键方法：

正确的装饰器示例 #

namespace App\Serializer;

use ApiPlatform\JsonLd\Serializer\ItemNormalizer;
use Symfony\Component\Serializer\Normalizer\NormalizerInterface;

class ItemNormalizerDecorator implements NormalizerInterface
{
    private ItemNormalizer $decorated;

    public function __construct(ItemNormalizer $decorated)
    {
        $this->decorated = $decorated;
    }

    // 必须完整传递所有参数，包括$context
    public function supportsNormalization($data, string $format = null, array $context = []): bool
    {
        return $this->decorated->supportsNormalization($data, $format, $context);
    }

    // 完整转发normalize调用
    public function normalize($object, string $format = null, array $context = [])
    {
        return $this->decorated->normalize($object, $format, $context);
    }

    // Symfony 5.4+ 必须实现此方法，转发给原服务
    public function getSupportedTypes(?string $format): array
    {
        return $this->decorated->getSupportedTypes($format);
    }
}

常见错误点 #

• 遗漏supportsNormalization方法的$context参数：原ItemNormalizer依赖$context判断是否处理当前对象，缺少该参数会导致判断逻辑失效，误处理非资源类。
• 未实现getSupportedTypes方法：Symfony 5.4+的序列化组件会用此方法判断Normalizer支持的类型，缺失会导致组件认为该装饰器支持所有类型，强制让ItemNormalizer处理非资源类。

2. 验证服务配置的正确性 #

在config/services.yaml中确保装饰器的配置符合Symfony装饰器规范：

services:
    App\Serializer\ItemNormalizerDecorator:
        decorates: api_platform.jsonld.normalizer.item
        arguments: ['@.inner'] # 必须注入被装饰的原服务实例
        tags:
            - { name: serializer.normalizer, priority: 101 } # 优先级需高于原服务（原服务默认优先级为100）

配置注意事项 #

• arguments必须使用@.inner：确保注入的是被装饰的api_platform.jsonld.normalizer.item实例，而非重新创建一个新的ItemNormalizer。
• 优先级设置：装饰器的优先级需高于原服务，确保序列化组件优先调用装饰器，再转发给原服务。

3. 排除Dto的误配置 #

确认FileMultipleResponseDto没有被错误标记为API Platform资源类：

• 检查Dto类上是否存在#[ApiResource]注解（或YAML/XML配置），如果没有，原ItemNormalizer本来就不会处理它，装饰后出现问题则回到前两步检查装饰器的实现。

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