Symfony4默认序列化器处理特殊实体属性名异常求助

看起来你遇到的问题是Symfony默认序列化器对特殊格式的实体属性名处理不符合预期，我来帮你梳理清楚原因并给出针对性解决方案。

问题根源 #

Symfony的ObjectNormalizer默认会通过getter/setter方法推断属性名：比如你的getPRODName()方法，它会去掉前缀get，然后将首字母小写，得到pRODName作为序列化后的键——这就是你看到当前结果的原因。而你需要的是还原成实体属性的原始命名PROD_Name，默认的命名转换器（包括CamelCaseToSnakeCaseNameConverter）都不匹配你的特殊命名规则，所以必须自定义转换逻辑。

解决方案一：自定义命名转换器（推荐） #

这个方案兼容getter/setter的使用，并且能统一应用到所有实体，完美适配你的场景。

1. 创建自定义NameConverter #

在src/Serializer目录下创建转换器类：

<?php
namespace App\Serializer;

use Symfony\Component\Serializer\NameConverter\NameConverterInterface;

class CustomNameConverter implements NameConverterInterface
{
    /**
     * 序列化时：将内部属性名（如pRODName）转换为目标格式（PROD_Name）
     */
    public function normalize(string $propertyName): string
    {
        // 先将首字母大写，再在连续大写前缀和后续驼峰之间添加下划线
        $capitalized = ucfirst($propertyName);
        return preg_replace('/([A-Z]+)([A-Z][a-z]+)/', '$1_$2', $capitalized);
    }

    /**
     * 反序列化时：将目标格式（PROD_Name）转换为内部属性名（pRODName）
     */
    public function denormalize(string $propertyName): string
    {
        // 去掉下划线，再将首字母小写以匹配getter/setter
        $noUnderscore = str_replace('_', '', $propertyName);
        return lcfirst($noUnderscore);
    }
}

2. 配置服务 #

在config/services.yaml中注册这个转换器，并绑定到ObjectNormalizer：

services:
    # 注册自定义命名转换器
    App\Serializer\CustomNameConverter:
        tags: ['serializer.name_converter']

    # 配置ObjectNormalizer使用自定义转换器
    Symfony\Component\Serializer\Normalizer\ObjectNormalizer:
        arguments:
            $nameConverter: '@App\Serializer\CustomNameConverter'
        tags: ['serializer.normalizer']

这样配置后，序列化时pRODName会被转换成PROD_Name，反序列化时PROD_Name也能正确匹配到setPRODName()方法。

解决方案二：直接序列化实体属性（备选） #

如果你不需要依赖getter/setter，想直接读取实体的私有属性名，可以修改ObjectNormalizer的配置，禁用getter/setter的使用：

# config/services.yaml
Symfony\Component\Serializer\Normalizer\ObjectNormalizer:
    arguments:
        $useGetters: false
        $useSetters: false
    tags: ['serializer.normalizer']

这种方式会直接使用实体的私有属性名（如$PROD_Name）作为序列化后的键，无需额外转换。但注意，这种方式不适合需要通过getter计算属性值的场景。

为什么默认转换器没用？ #

CamelCaseToSnakeCaseNameConverter的作用是将驼峰命名转换为全小写的蛇形命名（比如pRODName→prod_name），完全不符合你保留原始大小写和下划线的需求，所以无法解决问题。

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