PHP Symfony查询构建器使用DiscriminatorColumn报错问题求解

问题根因 #

你收到的报错和你添加的INSTANCE OF条件无关，报错触发点是profile.user_type这个字段引用：

• 鉴别器列是Doctrine ORM内部用于继承映射的特殊字段，默认仅作为数据库字段存在，不会映射为实体类的声明属性，因此DQL解析时会认为目标实体不存在该字段。
• 你添加的isInstanceOf('profile', Profile::class)条件本身没有实际作用，所有继承自Profile的子类实例都满足该条件，不会对查询结果产生筛选效果。

解决方案 #

方案1：直接用INSTANCE OF筛选目标实体类型（推荐） #

如果你只是要筛选出Club类型的实体，不需要手动编写鉴别器字段的匹配条件，直接指定INSTANCE OF的目标类为Club即可，Doctrine会自动在生成的SQL中拼接对应鉴别器值的匹配逻辑：

$qb = $this->createQueryBuilder('profile');
$qb->andWhere($qb->expr()->isInstanceOf('profile', Club::class));

方案2：将鉴别器列显式声明为实体属性（适用于需要动态匹配鉴别器值的场景） #

如果你有特殊需求需要直接在DQL中操作鉴别器的值，可以在父类Profile中显式声明该字段，注意要设置insertable=false和updatable=false避免和ORM自动维护的鉴别器逻辑冲突：

1. 调整Profile实体代码，添加对应属性：

/**
 * @ORM\Column(name="user_type", type="string", insertable=false, updatable=false)
 */
private $userType;

// 仅添加getter即可，不要提供setter避免手动修改值
public function getUserType(): string
{
    return $this->userType;
}

2. 调整你的查询代码，将字段名改为实体属性名：

$qb = $this->createQueryBuilder('profile');
$qb
    ->andWhere($qb->expr()->eq('profile.userType', ':type'))
    ->setParameter('type', 'club');

注意事项 #

• 显式声明鉴别器属性时，永远不要手动给该属性赋值，所有场景下鉴别器的值都由Doctrine根据实体类型自动维护。
• 没有特殊需求优先使用方案1，不需要额外修改实体代码，也不会引入人为操作鉴别器值的风险。

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