如何在EasyAdmin中添加带自定义查询的网格自定义列？

问题场景 #

需要在EasyAdmin的列表页添加实体中不存在的自定义列，比如统计关联的活跃用户数、特定日期后创建的用户数这类需要自定义查询/子查询的字段。尝试在createIndexQueryBuilder中添加额外字段时，触发了Cannot read property "id" from an array的错误。

测试用代码：

public function createIndexQueryBuilder(SearchDto $searchDto, EntityDto $entityDto, FieldCollection $fields, FilterCollection $filters): QueryBuilder
{
    // ... 原有逻辑
    $queryBuilder->addSelect('1 AS userCount');
    return $queryBuilder;
}

报错信息：

Cannot read property "id" from an array. Maybe you intended to write the property path as "[id]" instead.

查询结果结构变化：原本返回纯实体对象数组，现在变成了实体对象与自定义字段组成的数组：

-results: ArrayIterator {#900 ▼
    -storage: array:10 [▼
      0 => array:2 [▼
        0 => App\Entity\Company {#916 ▶}
        "userCount" => 1
      ]
      1 => array:2 [▼
        0 => App\Entity\Company {#814 ▶}
        "userCount" => 1
      ]

错误原因 #

EasyAdmin默认期望查询返回单一实体对象，当用addSelect添加额外字段时，Doctrine会返回实体对象+自定义字段的混合数组，而EasyAdmin的列表渲染逻辑会直接尝试从这个数组读取实体的id属性，从而触发错误。

解决方法 #

方法1：实体添加虚拟属性（推荐） #

通过在实体中添加虚拟属性，让Doctrine将自定义查询结果注入到实体中，保持返回结构为实体对象。

1. 在目标实体（如Company）中添加虚拟属性及getter/setter：

// src/Entity/Company.php
class Company
{
    // ... 原有实体属性与方法

    private ?int $userCount = null;

    public function getUserCount(): ?int
    {
        return $this->userCount;
    }

    public function setUserCount(?int $userCount): self
    {
        $this->userCount = $userCount;
        return $this;
    }
}

2. 修改createIndexQueryBuilder，用HIDDEN关键字让Doctrine自动映射值到虚拟属性：

public function createIndexQueryBuilder(SearchDto $searchDto, EntityDto $entityDto, FieldCollection $fields, FilterCollection $filters): QueryBuilder
{
    $qb = parent::createIndexQueryBuilder($searchDto, $entityDto, $fields, $filters);
    
    // 示例：统计关联的活跃用户数
    $qb->addSelect('(SELECT COUNT(u.id) FROM App\Entity\User u WHERE u.company = c AND u.isActive = 1) AS HIDDEN userCount');
    $qb->addSelect('c'); // 确保选中实体本身

    return $qb;
}

HIDDEN关键字会让Doctrine将userCount的值注入到实体的同名属性中，不会返回数组结构。

3. 在CrudController的configureFields中添加该字段：

public function configureFields(string $pageName): iterable
{
    return [
        // ... 原有字段
        IntegerField::new('userCount', '活跃用户数')->onlyOnIndex(),
    ];
}

方法2：自定义字段渲染逻辑 #

如果不想修改实体类，可以在字段配置中手动从查询返回的数组里提取自定义值。

1. 修改createIndexQueryBuilder（无需HIDDEN）：

public function createIndexQueryBuilder(SearchDto $searchDto, EntityDto $entityDto, FieldCollection $fields, FilterCollection $filters): QueryBuilder
{
    $qb = parent::createIndexQueryBuilder($searchDto, $entityDto, $fields, $filters);
    
    // 示例：统计近30天新增用户数
    $qb->addSelect('(SELECT COUNT(u.id) FROM App\Entity\User u WHERE u.company = c AND u.createdAt > :date) AS userCount');
    $qb->setParameter('date', new \DateTime('-30 days'));

    return $qb;
}

2. 在configureFields中配置字段，手动处理数组结果：

public function configureFields(string $pageName): iterable
{
    return [
        // ... 原有字段
        IntegerField::new('userCount', '近30天新增用户数')
            ->onlyOnIndex()
            ->setValue(function ($entityOrArray) {
                if (is_array($entityOrArray)) {
                    return $entityOrArray['userCount'];
                }
                return null;
            }),
    ];
}

注意：这种方式在使用搜索、筛选功能时，可能需要额外适配自定义字段的查询逻辑。

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