Symfony嵌入实体类字段映射嵌套问题：如何修改映射名称？

针对你遇到的嵌入类字段映射被识别为嵌套名称（如id.id）的问题，有以下几种可行方案：

方案一：自定义Doctrine事件订阅者修改字段映射 #

通过监听Doctrine的loadClassMetadata事件，在元数据加载阶段自动将嵌套的字段映射键替换为最终属性名，同时支持多层嵌入的处理。

1. 创建事件订阅者类 #

// src/Doctrine/EmbeddedFieldMappingSubscriber.php
namespace App\Doctrine;

use Doctrine\Common\EventSubscriber;
use Doctrine\ORM\Events;
use Doctrine\ORM\Mapping\ClassMetadata;

class EmbeddedFieldMappingSubscriber implements EventSubscriber
{
    public function getSubscribedEvents(): array
    {
        return [Events::loadClassMetadata];
    }

    public function loadClassMetadata($eventArgs): void
    {
        /** @var ClassMetadata $metadata */
        $metadata = $eventArgs->getClassMetadata();

        foreach ($metadata->embeddedClasses as $embeddedProperty => $embeddedDef) {
            $this->flattenEmbeddedFieldMappings($metadata, $embeddedProperty, $embeddedDef['class']);
        }
    }

    private function flattenEmbeddedFieldMappings(ClassMetadata $parentMetadata, string $parentProperty, string $embeddedClass): void
    {
        $em = $parentMetadata->getEntityManager();
        $embeddedMetadata = $em->getClassMetadata($embeddedClass);

        // 处理当前嵌入类的字段映射
        foreach ($embeddedMetadata->fieldMappings as $fieldName => $fieldMapping) {
            $nestedKey = sprintf('%s.%s', $parentProperty, $fieldName);
            if (isset($parentMetadata->fieldMappings[$nestedKey])) {
                // 将嵌套映射迁移到最终属性名
                $parentMetadata->fieldMappings[$fieldName] = $parentMetadata->fieldMappings[$nestedKey];
                $parentMetadata->fieldMappings[$fieldName]['columnName'] = $fieldMapping['columnName'];
                unset($parentMetadata->fieldMappings[$nestedKey]);

                // 更新字段与列名的映射关系
                $parentMetadata->fieldNames[$fieldName] = $fieldMapping['columnName'];
                unset($parentMetadata->fieldNames[$nestedKey]);
            }
        }

        // 递归处理多层嵌套嵌入
        foreach ($embeddedMetadata->embeddedClasses as $embeddedProp => $embeddedDef) {
            $this->flattenEmbeddedFieldMappings(
                $parentMetadata,
                sprintf('%s.%s', $parentProperty, $embeddedProp),
                $embeddedDef['class']
            );
        }
    }
}

2. 注册订阅者 #

在config/services.yaml中添加服务标签，让Symfony自动识别这个Doctrine事件订阅者：

# config/services.yaml
services:
    App\Doctrine\EmbeddedFieldMappingSubscriber:
        tags:
            - { name: doctrine.event_subscriber }

这个方案的优势是完全不破坏嵌入类的复用性，自动适配多层嵌套场景，符合项目实体标准化的需求。

方案二：手动同步实体字段与嵌入类属性 #

如果项目场景简单，可以在实体类中直接定义目标字段，同时保留嵌入类实例，通过getter/setter同步两者的属性值，ORM映射指向同一数据库列。

示例代码：

// src/Entity/MyClass.php
namespace App\Entity;

use App\Embeddable\IdColumn;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity]
class MyClass
{
    #[ORM\Id]
    #[ORM\Column(type: 'uuid')] // 与IdColumn中id字段的类型保持一致
    private $id;

    #[ORM\Embedded(class: IdColumn::class, columnPrefix: false)]
    private $idEmbedded;

    public function __construct()
    {
        $this->idEmbedded = new IdColumn();
    }

    public function getId()
    {
        return $this->id;
    }

    public function setId($id): self
    {
        $this->id = $id;
        $this->idEmbedded->setId($id);
        return $this;
    }
}

该方案的缺点是需要手动同步实体字段与嵌入类属性，维护成本较高，多层嵌入时会更繁琐，仅适合简单场景。

方案三：升级Doctrine版本（可选） #

如果项目允许升级，Doctrine 2.14及以上版本对嵌入类的配置有更灵活的支持，可以查看官方文档是否有直接控制字段映射名的配置项，不过此方案需要评估升级带来的兼容性风险。

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