Doctrine ORM查询用户角色遇QueryException及SQL列不存在问题

问题1：QueryBuilder执行IN查询触发QueryException #

错误原因 #

1. 多对多关联的u.roles是集合类型字段，Doctrine不允许直接对集合使用IN表达式——要求路径表达式必须是单值字段或单值关联字段。
2. 代码存在参数名不匹配：SQL中绑定的是:roleTypes，但setParameter使用的参数名是'roleType'，导致参数无法正确绑定。

解决方案 #

需要先关联roles集合，再针对关联的Role实体设置条件，以下是两种可行写法：

写法1：JOIN关联后匹配Role实体

通过JOIN关联角色集合，直接匹配Role对象，若需避免同一用户重复返回，可添加distinct()：

$qb->select('u')
    ->from(\Eho\Core\Entity\User::class, 'u')
    ->join('u.roles', 'r') // 关联roles集合，设置别名r
    ->where($qb->expr()->in('r', ':roleTypes'))
    ->setParameter('roleTypes', $roleTypes)
    ->distinct(); // 可选：去重重复的用户结果

写法2：使用EXISTS子查询

适合不需要返回Role数据的场景，直接查询关联表：

// 构建子查询：获取拥有目标角色的用户ID列表
$subQb = $qb->getEntityManager()->createQueryBuilder()
    ->select('ur.user_id')
    ->from('user_role', 'ur')
    ->where($qb->expr()->in('ur.role_id', ':roleIds'));

// 主查询：筛选出存在于子查询结果中的用户
$qb->select('u')
    ->from(\Eho\Core\Entity\User::class, 'u')
    ->where($qb->expr()->exists($subQb->getDQL()))
    ->setParameter('roleIds', array_map(function($role) {
        return $role->getId();
    }, (array)$roleTypes));

问题2：findByRoles查询触发SQL列不存在异常 #

错误原因 #

1. 方法名错误：Doctrine Repository没有findByRoles内置方法，多条件查询需使用通用的findBy()方法，传入关联属性名作为查询键。
2. 实体映射不一致：User实体中Role的targetEntity命名空间为\App\User\Entity\Role，但实际Role实体是\App\Entity\Role，命名空间不匹配会导致Doctrine生成错误的SQL映射。
3. 关联表结构问题：user_role表的id列未设置为主键，且多对多关联表通常不需要单独的ID字段，易引发映射异常。

解决方案 #

步骤1：修正查询方法

使用findBy()替代错误的findByRoles()：

// 查询拥有单个角色的用户
$users = $em->getRepository(\Eho\Core\Entity\User::class)->findBy(['roles' => $role]);

// 查询拥有多个角色的用户
$users = $em->getRepository(\Eho\Core\Entity\User::class)->findBy(['roles' => $roles]);

步骤2：修正实体映射的命名空间

确保User实体中Role的targetEntity与实际Role实体的命名空间一致：

// User实体中的roles关联配置
/**
 * @ORM\ManyToMany(targetEntity="\App\Entity\Role") // 修正为实际的Role命名空间
 * @ORM\JoinTable(name="user_role",
 *       joinColumns={@ORM\JoinColumn(name="user_id", referencedColumnName="id")},
 *       inverseJoinColumns={@ORM\JoinColumn(name="role_id", referencedColumnName="id")}
 *       )
 */
private $roles;

步骤3：优化关联表结构（推荐）

修改user_role表，移除单独的id字段，将user_id和role_id设为复合主键，符合多对多关联表的最佳实践：

DROP TABLE IF EXISTS user_role;
CREATE TABLE user_role (
    user_id int(11) UNSIGNED NOT NULL,
    role_id int(11) UNSIGNED NOT NULL,
    PRIMARY KEY (user_id, role_id),
    FOREIGN KEY (user_id) REFERENCES user(id),
    FOREIGN KEY (role_id) REFERENCES roles(id)
);

内容的提问来源于stack exchange，提问作者JI-Web