Doctrine 2.12 持续为columnDefinition属性生成重复迁移问题

问题根源 #

你遇到的核心问题是手动配置columnDefinition与generated属性时，Doctrine无法正确解析数据库实际字段定义和映射文件的匹配关系，导致每次执行doctrine:schema:validate都判定不一致，make:migration重复生成相同的ALTER语句。MySQL 8.0的自动时间戳字段（DEFAULT CURRENT_TIMESTAMP/ON UPDATE CURRENT_TIMESTAMP）和Doctrine的映射规则存在细节冲突，硬写columnDefinition很容易出现这种比对不匹配的情况。

解决方案 #

方案1：移除columnDefinition，使用Doctrine原生配置 #

放弃手动写columnDefinition，改用Doctrine支持的options和generated属性组合，让框架自动生成匹配的数据库字段定义：

use Doctrine\ORM\Mapping as ORM;

trait TimestampableTrait
{
    #[ORM\Column(type: 'datetime_immutable', nullable: false, options: ['default' => 'CURRENT_TIMESTAMP'])]
    #[ORM\Generated('INSERT')]
    private \DateTimeImmutable $createdAt;

    #[ORM\Column(type: 'datetime_immutable', nullable: false, options: ['default' => 'CURRENT_TIMESTAMP', 'onUpdate' => 'CURRENT_TIMESTAMP'])]
    #[ORM\Generated('ALWAYS')]
    private \DateTimeImmutable $updatedAt;

    #[ORM\PrePersist]
    public function initializeCreatedAt(): void
    {
        if (!$this->createdAt) {
            $this->createdAt = new \DateTimeImmutable();
        }
    }

    #[ORM\PreUpdate]
    public function updateUpdatedAt(): void
    {
        $this->updatedAt = new \DateTimeImmutable();
    }
}

注意：

• generated: 'INSERT'对应MySQL插入时自动填充默认值的逻辑
• generated: 'ALWAYS'对应更新时自动刷新时间戳的逻辑
• 确保nullable: false和数据库实际字段的非空约束一致（Doctrine默认字段非空，不要遗漏）

方案2：改用成熟的Timestampable扩展 #

直接使用stof/doctrine-extensions-bundle的Timestampable功能，避免手动配置的坑：

1. 安装扩展：

composer require stof/doctrine-extensions-bundle

2. 配置启用Timestampable：
   在config/packages/stof_doctrine_extensions.yaml中添加：

stof_doctrine_extensions:
    orm:
        default:
            timestampable: true

3. 简化Trait代码：

use Gedmo\Timestampable\Traits\TimestampableEntity;

trait TimestampableTrait
{
    use TimestampableEntity;
}

这个扩展已经处理好了所有映射细节和数据库兼容性，不会出现schema验证不一致的问题。

关键检查项 #

• 确认config/packages/doctrine.yaml中的serverVersion严格设置为'8.0'，不要写成mysql-8.0或其他格式，Doctrine对版本字符串的解析很严格。
• 执行完新的迁移后，手动查看数据库字段定义，确保和映射配置完全一致（包括非空约束、默认值、更新规则）。

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