Symfony查询ROLE_MODERATOR角色用户报错，求解决及标准方法

错误原因 #

你遇到的报错是因为roles字段在数据库中存储为JSON格式（比如["ROLE_MODERATOR"]），直接用=运算符匹配字符串ROLE_MODERATOR会导致类型不兼容，数据库找不到对应的运算符来处理JSON与字符串的匹配。

修复自定义仓库方法 #

针对JSON类型的roles字段，需要用数据库支持的JSON查询函数来匹配数组中的元素，以下是不同数据库的可行写法：

适用于MySQL/PostgreSQL的通用写法 #

public function getModerators()
{
    $role = 'ROLE_MODERATOR';

    return $this->createQueryBuilder('u')
        ->where('JSON_CONTAINS(u.roles, :role) = true')
        ->setParameter('role', sprintf('"%s"', $role)) // JSON字符串需要带双引号
        ->getQuery()
        ->getResult();
}

针对PostgreSQL的jsonb类型优化 #

如果你的roles字段是jsonb类型（PostgreSQL推荐的JSON存储类型），可以用更高效的jsonb_contains：

public function getModerators()
{
    $role = 'ROLE_MODERATOR';

    return $this->createQueryBuilder('u')
        ->where('jsonb_contains(u.roles, :role)')
        ->setParameter('role', json_encode($role))
        ->getQuery()
        ->getResult();
}

Symfony的标准实现方式 #

Symfony Security组件没有直接提供获取指定角色用户的封装方法，但可以通过Doctrine的规范查询实现：

使用Doctrine Criteria（适用于Symfony 5.4+） #

use Doctrine\Common\Collections\Criteria;

public function findByRole(string $role)
{
    $criteria = Criteria::create()
        ->where(Criteria::expr()->contains('roles', $role));

    return $this->matching($criteria)->toArray();
}

注：这种写法依赖Doctrine对JSON字段的contains方法支持，部分数据库驱动可能需要额外配置。

补充说明 #

确保你的User实体中roles字段的映射正确，通常生成的代码是这样的：

/**
 * @ORM\Column(type="json")
 */
private array $roles = [];

Symfony用户角色默认以数组形式存储，查询时要匹配数组中的元素，而非整个字段等于目标角色字符串。

内容的提问来源于stack exchange，提问作者ШайтанЯкубович