Doctrine orWhere查询返回异常结果，求排查原因

我来帮你拆解下原代码的问题，以及如何用Doctrine原生方法正确实现分类筛选～

原代码的核心错误 #

你的代码问题出在重复使用了同一个参数名:category。Doctrine的QueryBuilder在处理参数时，相同的参数名会被最后一次调用setParameter的值覆盖。举个例子：

• 当你传入全部分类（CAT1到CAT4）时，循环里每次都把:category设置为当前分类的模糊匹配值，最终:category会被替换成%CAT4%。这就导致所有的orWhere条件实际上都变成了fe.categories LIKE '%CAT4%'——这就是为什么选择全部分类时只返回含CAT4的条目。
• 当你仅选择CAT1时，看起来结果异常，大概率是测试时的参数缓存，或者你的categories字段存储的是序列化数组（比如含CAT1的条目里恰好包含CAT4的字符串片段），但核心问题还是参数名重复导致的逻辑偏差。

用Doctrine原生方法的正确实现 #

这里提供两种更规范的写法，都能避免参数覆盖的问题：

方法1：给每个参数生成唯一名称

通过循环索引给参数命名，确保每个分类对应唯一的参数：

if ($categories) {
    foreach ($categories as $index => $category) {
        if (CategoryEnum::isValid($category)) {
            $paramName = 'category_' . $index;
            $queryBuilder
                ->orWhere('fe.categories LIKE :' . $paramName)
                ->setParameter($paramName, '%' . $category . '%');
        }
    }
}

方法2：用Expr构建OR条件组（更推荐）

把所有OR条件收集成数组，再通过Expr\Orx组合成一个完整的条件组，结构更清晰，也避免循环中多次调用orWhere可能带来的逻辑混乱：

use Doctrine\ORM\Query\Expr;

// ...

if ($categories) {
    $orConditions = [];
    foreach ($categories as $index => $category) {
        if (CategoryEnum::isValid($category)) {
            $paramName = 'category_' . $index;
            // 构建单个LIKE条件
            $orConditions[] = $queryBuilder->expr()->like('fe.categories', ':' . $paramName);
            // 绑定对应参数
            $queryBuilder->setParameter($paramName, '%' . $category . '%');
        }
    }
    
    // 只有当有有效条件时才添加到查询中
    if (!empty($orConditions)) {
        $queryBuilder->andWhere(new Expr\Orx($orConditions));
    }
}

额外优化建议 #

如果你的categories字段是数据库的JSON类型（比如MySQL JSON），建议用更精准的匹配方式替代LIKE，避免误匹配（比如分类"CAT12"会被LIKE '%CAT1%'错误匹配）。可以用Doctrine的isMemberOf或者JSON函数：

if ($categories) {
    $orConditions = [];
    foreach ($categories as $index => $category) {
        if (CategoryEnum::isValid($category)) {
            $paramName = 'category_' . $index;
            // 用isMemberOf检查分类是否在数组中（需Doctrine支持）
            $orConditions[] = $queryBuilder->expr()->isMemberOf(':' . $paramName, 'fe.categories');
            $queryBuilder->setParameter($paramName, $category);
        }
    }
    
    if (!empty($orConditions)) {
        $queryBuilder->andWhere(new Expr\Orx($orConditions));
    }
}

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