使用Gedmo Timestampable时created_at未自动填充引发约束违规

出现Integrity constraint violation: 1048 Column 'created_at' cannot be null错误，核心原因是Gedmo的Timestampable监听器未正常工作，导致字段未被自动填充。以下是排查和解决步骤：

1. 确认Gedmo扩展已正确注册到Doctrine #

这是最常见的问题根源，必须确保Timestampable的扩展/监听器被Doctrine加载：

• 若为Symfony项目，在config/packages/doctrine.yaml中添加Gedmo扩展配置：

  doctrine:
      orm:
          entity_managers:
              default:
                  extensions:
                      Gedmo\Timestampable\TimestampableExtension: ~
  

• 若为原生Doctrine项目，需手动注册监听器：

  use Gedmo\Timestampable\TimestampableListener;
  use Doctrine\ORM\EntityManager;
  use Doctrine\Common\Annotations\AnnotationReader;
  
  $annotationReader = new AnnotationReader();
  $listener = new TimestampableListener();
  $listener->setAnnotationReader($annotationReader);
  
  $entityManager = EntityManager::create($dbParams, $config);
  $entityManager->getEventManager()->addEventSubscriber($listener);
  

2. 检查注解命名空间是否正确 #

确保实体类中引入的是正确的Timestampable注解：

use Gedmo\Timestampable\Annotation\Timestampable; // 正确命名空间
use Doctrine\ORM\Mapping as ORM;

引入错误命名空间会导致注解被Doctrine直接忽略。

3. 清除Doctrine元数据缓存 #

旧的元数据缓存可能导致新添加的注解不生效，执行缓存清除命令：

# Symfony项目
php bin/console doctrine:cache:clear-metadata

# 原生Doctrine
$entityManager->getConfiguration()->getMetadataCacheImpl()->deleteAll();

4. 确认使用EntityManager标准操作流程 #

如果直接通过DBAL连接执行原生SQL，而非EntityManager::persist()和flush()方法操作实体，Gedmo的监听器不会触发，必须遵循Doctrine的实体管理流程操作数据。

5. 字段初始化（临时兜底方案） #

虽然核心是让监听器工作，但可以给字段设置默认null值，避免监听器未生效时的临时报错：

#[ORM\Column]
#[Gedmo\Timestampable(on: 'create')]
private ?\DateTime $createdAt = null;

#[ORM\Column]
#[Gedmo\Timestampable]
private ?\DateTime $updatedAt = null;

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