Symfony中修改嵌入式字段名称以解决“Unrecognized field: App\Domain\Entity\User::$email”报错问题

我太懂你踩的这个坑了！用Doctrine嵌入值对象确实能让领域模型更优雅，但架不住Symfony Security和LexikJWT查询用户时，不认这种嵌套的字段结构。先把问题根源捋清楚：

你用嵌入式值对象封装了Email，虽然数据库列名是email，但Doctrine的元数据里，User实体的email属性是一个嵌入对象，实际对应的字段映射是email.value，而非直接的email。当LexikJWT或Symfony Security尝试用email作为查询条件时，Doctrine找不到这个字段，自然就抛出“Unrecognized field”的错误了。

下面给你几个可行的解决办法，按优雅程度排序：

方法一：自定义用户提供者（最推荐，符合DDD风格） #

咱们自己控制用户加载逻辑，直接在DQL里指定嵌入对象的属性，避开Doctrine字段映射的问题。

1. 创建自定义用户提供者类 #

namespace App\Infrastructure\Security;

use App\Domain\Entity\User;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Component\Security\Core\User\UserInterface;
use Symfony\Component\Security\Core\User\UserLoaderInterface;

class CustomUserProvider implements UserLoaderInterface
{
    public function __construct(private EntityManagerInterface $entityManager)
    {}

    public function loadUserByIdentifier(string $identifier): ?UserInterface
    {
        // 直接用DQL查询嵌入对象的value属性
        return $this->entityManager->getRepository(User::class)
            ->createQueryBuilder('u')
            ->where('u.email.value = :email')
            ->setParameter('email', $identifier)
            ->getQuery()
            ->getOneOrNullResult();
    }
}

2. 配置Security使用这个提供者 #

在config/packages/security.yaml里修改用户提供者配置：

security:
    providers:
        app_user_provider:
            id: App\Infrastructure\Security\CustomUserProvider # 指向自定义类

这样Security就会用咱们写的逻辑查询用户，既绕开了Doctrine字段映射的问题，又保持了值对象的封装性。

方法二：调整Security的查询构建器（快速解决，无需新增类） #

如果不想写新类，也可以直接在Security配置里自定义查询构建器，指定正确的DQL字段：

security:
    providers:
        app_user_provider:
            entity:
                class: App\Domain\Entity\User
                query_builder: |
                    function(\Doctrine\ORM\EntityRepository $repo) {
                        return $repo->createQueryBuilder('u')
                            ->where('u.email.value = :identifier');
                    }

这个方法更简洁，适合快速调试，本质和自定义提供者一致，都是用正确的DQL路径查询。

方法三：添加冗余字段（不推荐，但简单直接） #

如果上面两种方法都嫌麻烦，可以在User实体里加一个直接映射到数据库email列的冗余属性，同步值对象的内容：

1. 修改User实体 #

添加新属性并同步值：

// 在User类里新增
/**
 * @ORM\Column(type="string", name="email", nullable=false)
 */
private string $emailDb;

// 构造函数里初始化
public function __construct(
    private UuidInterface $id,
    private Name $name,
    private Surname $surname,
    private Email $email,
    private Password $password,
    private array $roles = []
) {
    $this->emailDb = $email->value();
}

// 更新set方法同步值
public function setEmail(string $email): void
{
    $this->email = new Email($email);
    $this->emailDb = $email;
}

public function setVOEmail(Email $email): void
{
    $this->email = $email;
    $this->emailDb = $email->value();
}

2. 配置Security使用这个冗余字段 #

security:
    providers:
        app_user_provider:
            entity:
                class: App\Domain\Entity\User
                property: emailDb

这个方法虽然简单，但会引入冗余代码，破坏值对象的封装性，只适合临时解决问题，不建议长期使用。

最后提醒你，确认User实体的getUserIdentifier()方法返回$this->email->value()，你已经写对了，这是Symfony Security的要求，没问题。

备注：内容来源于stack exchange，提问作者user3447780