Symfony 6.2+Doctrine新增数据报主键重复1062错误求助

场景还原 #

实体定义：

#[ORM\Entity(repositoryClass: CommunicationRepository::class)]
class Communication
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    private ?int $id = null;
    // 其他字段...
}

数据表SQL：

create table if not exists communication
(
    id              int auto_increment
        primary key,
    -- 其他字段...
);

业务代码：

$obj = new Communication();
$obj->setSender($givenSender); // 设置其他字段
$this->emMessaging->persist($obj);
$this->emMessaging->flush();

错误信息：

An exception occurred while executing a query:
SQLSTATE[23000]: Integrity constraint violation:
1062 Duplicate entry '0' for key 'communication.PRIMARY'

注：表为空，手动执行生成的SQL可正常插入并生成有效ID，但代码执行报错。

解决方法 #

1. 明确指定主键生成策略 #

Doctrine默认的GeneratedValue策略可能在部分环境下未正确识别MySQL自增类型，显式指定策略为IDENTITY：

#[ORM\Id]
#[ORM\GeneratedValue(strategy: 'IDENTITY')]
#[ORM\Column(type: 'integer')]
private ?int $id = null;

IDENTITY策略专门适配MySQL自增主键，确保Doctrine不主动设置ID值，完全依赖数据库自增逻辑。

2. 验证实体与数据库结构匹配 #

执行Doctrine schema验证命令，检查实体映射与数据库表结构是否存在差异：

php bin/console doctrine:schema:validate

若提示不匹配，执行同步命令修复：

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

3. 重置数据库自增计数器 #

即使表为空，自增计数器可能因历史操作出现异常，手动重置：

ALTER TABLE communication AUTO_INCREMENT = 1;

4. 排查隐性ID赋值逻辑 #

检查业务代码中是否存在意外设置id=0的情况：

• 表单提交或API请求中是否传入了id=0参数
• 实体的setId方法是否被误调用
• DTO转换、数据填充过程中是否错误赋值ID字段

5. 清理Doctrine元数据缓存 #

元数据缓存可能导致策略识别错误，执行清理命令：

php bin/console doctrine:cache:clear-metadata
php bin/console cache:clear

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