Doctrine操作PostgreSQL布尔字段时SQL用整数引发报错的解决咨询

问题场景 #

使用Doctrine QueryBuilder更新PostgreSQL布尔字段时，执行如下代码：

$qb = $this->getEntityManager()->createQueryBuilder()
                ->update('MyBundle:Message', 'message')
                ->set('message.read', 'true');

生成的SQL会把布尔值转为整数：

UPDATE project.message SET read= 1 WHERE ID = ?

触发PostgreSQL报错：

ERROR: column "read" is of type boolean but expression is of type integer

实体类字段定义如下：

/**
 * @var boolean
 *
 * @ORM\Column(name="READ", type="boolean", nullable=false)
 */
private $read = false;

最优解决方案 #

方案1：使用参数绑定并指定字段类型 #

这是最规范的做法，让Doctrine自动处理类型映射，避免手动转换错误：

$qb = $this->getEntityManager()->createQueryBuilder()
    ->update('MyBundle:Message', 'message')
    ->set('message.read', ':isRead')
    ->setParameter('isRead', true, \Doctrine\DBAL\Types\Types::BOOLEAN);

通过setParameter明确指定参数类型为BOOLEAN，Doctrine会生成符合PostgreSQL要求的SQL，将布尔值正确转换为true字面量而非整数。

方案2：直接操作实体对象（推荐ORM原生用法） #

如果是单个实体更新，直接操作实体对象再执行flush，Doctrine会自动处理字段类型，无需手动拼接SQL：

$message = $this->getEntityManager()->find(MyBundle\Message::class, 225);
$message->setRead(true);
$this->getEntityManager()->flush();

这种方式更符合ORM的设计理念，代码更简洁，也避免了QueryBuilder的类型转换问题。

方案3：使用Doctrine表达式生成字面量 #

如果坚持用QueryBuilder的set方法直接传值，可以借助Expr::literal生成正确的布尔字面量：

use Doctrine\ORM\Query\Expr;

$qb = $this->getEntityManager()->createQueryBuilder()
    ->update('MyBundle:Message', 'message')
    ->set('message.read', Expr::literal(true));

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