Symfony Doctrine：使用NEW运算符水合含子DTO的结果

1. 先修正实体关联的错误 #

你的PersonEntity里的childId字段同时使用#[Column]和#[OneToOne]注解是错误的。OneToOne关联应直接关联ChildEntity对象，而非存储id的字段。正确的实体定义如下：

#[Entity]
#[Table(name: 'person')]
readonly class PersonEntity
{
    public function __construct(
        #[Id]
        #[GeneratedValue]
        #[Column(type: Types::INTEGER)]
        public ?int $id = null,
        #[Column(type: Types::STRING, length: 255)]
        public ?string $slug = null,
        #[Column(type: Types::STRING, length: 255)]
        public ?string $firstName = null,
        #[Column(type: Types::STRING, length: 255)]
        public ?string $lastName = null,
        // 修正OneToOne关联：关联实体对象，而非id字段
        #[OneToOne(targetEntity: ChildEntity::class, fetch: 'EAGER')] // 按需设置fetch模式
        #[JoinColumn(name: 'child_id', referencedColumnName: 'id')]
        public ?ChildEntity $child = null,
    )
    {
    }
}

#[Entity]
#[Table(name: 'child')]
readonly class ChildEntity
{
    public function __construct(
        #[Id]
        #[GeneratedValue]
        #[Column(type: Types::INTEGER)]
        public ?int $id = null,
        #[Column(type: Types::STRING, length: 255)]
        public ?string $slug = null,
        #[Column(type: Types::STRING, length: 255)]
        public ?string $firstName = null,
        #[Column(type: Types::STRING, length: 255)]
        public ?string $lastName = null,
    )
    {
    }
}

修正后，Doctrine会自动处理关联关系，查询Person时可直接获取关联的Child对象，无需手动构造DTO。

2. 若确实需要使用DTO而非实体关联 #

如果业务场景必须用DTO（比如Person和Child是DTO类而非实体），原DQL报错是因为CASE语句的两个分支返回类型不匹配（一个是NULL，一个是Child实例），Doctrine DQL要求CASE所有分支返回相同类型。

有两种解决方式：

方法一：用COALESCE构造空Child DQL #

构造一个所有属性为NULL的Child实例替代NULL，保证类型一致：

$select = 'NEW Person(
    a.id, 
    a.slug, 
    a.firstName, 
    a.lastName, 
    COALESCE(NEW Child(c.id, c.slug, c.firstName, c.lastName), NEW Child(NULL, NULL, NULL, NULL))
)';

$query = $this->entityManager->createQueryBuilder()
    ->select($select)
    ->from(PersonEntity::class, 'a')
    ->leftJoin(ChildEntity::class, 'c', Join::WITH, 'a.childId = c.id')
    ->getQuery();

后续业务逻辑中可通过判断Child的id是否为NULL来确定是否存在关联。

方法二：自定义DQL函数（适合复杂场景） #

如果频繁需要处理这种NULL转空对象的场景，可自定义DQL函数允许返回NULL作为实体/DTO类型，但需额外配置，适合复杂业务场景。

3. 结论 #

• 若使用实体关联，修正注解后Doctrine可自动关联加载子对象，无需手动构造；
• 若使用DTO，通过统一CASE分支的返回类型（如返回空Child实例），Doctrine可自动构建包含子DTO的结果，无需手动水合数组；
• 仅在极端复杂场景下，才需要手动水合数组构建对象。

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