Symfony Doctrine布尔字段无法默认设为0的问题排查

问题根源 #

Doctrine不会自动读取数据库字段的默认值来填充实体属性，而是完全依赖实体类中属性的初始值。你之前的配置失效核心原因：

1. options={"default":"0"}仅用于生成数据库Schema时设置默认值，不会影响实体实例的属性初始状态；
2. 你的setter参数声明为bool $autoCreated，PHP严格类型约束下无法传入null，所以内部的null判断逻辑永远不会触发。

有效解决方案 #

1. 直接给实体属性赋初始默认值（推荐）

在类的私有属性定义时直接初始化false（对应数据库的0），实体实例创建时该字段就不会是null：

/**
 * @ORM\Column(type="boolean", options={"default":"0"})
 */
private $autoCreated = false;  

Doctrine在持久化时会自动使用这个初始值，无需手动调用setter，就能避免向数据库传递null。

2. 修复Setter方法（可选，如需支持传入null的场景）

如果需要允许传入null并自动转为默认值，需将参数改为可空布尔类型?bool，简化判断逻辑：

public function setAutoCreated(?bool $autoCreated): self
{
    // 传入null时自动设为false
    $this->autoCreated = $autoCreated ?? false;
    return $this;
}

3. 同步Doctrine Schema与数据库（辅助验证）

确保实体映射与数据库结构完全一致，执行以下命令更新Schema：

php bin/console doctrine:schema:update --force

为什么之前的方法无效？ #

• options={"default":"0"}：仅作用于数据库层面，Doctrine不会读取这个值来填充实体属性；
• 原Setter的bool参数：PHP严格类型约束下，传入null会直接触发类型错误，内部的is_null判断根本不会执行。

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