DBAL QueryBuilder绑定INT数组至WHERE IN时触发数组转字符串异常

安全阿岳

2026-5-13

解决DBAL QueryBuilder中WHERE IN绑定整数数组的"Array to string conversion"错误

嗨，我来帮你搞定这个头疼的问题！你遇到的数组转字符串错误，核心原因是DBAL QueryBuilder的expr()->in()方法并不能直接识别单个命名参数绑定的数组——哪怕你加了PARAM_INT_ARRAY也不行，因为它会把:categories当成单个参数处理，尝试把数组转成字符串填充进去，自然就报错了。

给你两种靠谱的解决方案，按需选用：

方案一：用匿名占位符+批量绑定（推荐）

这种方式利用DBAL的PARAM_INT_ARRAY特性，批量绑定整数数组，代码简洁且性能更好：

$categoryIds = [1, 2];
$qb = $this->_em->getConnection()->createQueryBuilder()
    ->select('c.id AS id')
    ->from('category', 'c');

// 根据数组长度生成对应数量的?占位符
$placeholderStr = implode(', ', array_fill(0, count($categoryIds), '?'));
$qb->andWhere("c.id IN ($placeholderStr)");

// 直接绑定整个数组，指定整数数组类型
$qb->setParameter(0, $categoryIds, \Doctrine\DBAL\Connection::PARAM_INT_ARRAY);

// 执行查询
$result = $qb->execute()->fetchAll();

方案二：生成多个命名参数（兼容性更强）

如果你的DBAL版本较低，或者需要更灵活的参数控制，可以手动生成命名参数：

$categoryIds = [1, 2];
$qb = $this->_em->getConnection()->createQueryBuilder();

$placeholders = [];
$params = [];

// 遍历数组生成独立的命名参数
foreach ($categoryIds as $index => $id) {
    $paramName = ":cat_id_{$index}";
    $placeholders[] = $paramName;
    $params[$paramName] = $id;
}

$qb->select('c.id AS id')
    ->from('category', 'c')
    ->andWhere($qb->expr()->in('c.id', implode(', ', $placeholders)))
    ->setParameters($params);

$result = $qb->execute()->fetchAll();