PostgreSQL与Doctrine中UNIQUE约束失效问题排查

结合你用Symfony命令批量插入Country实体的场景，以下是几种可能导致约束失效的原因：

• 约束根本没生效
  先确认数据库迁移是否真的执行成功。可以直接在PostgreSQL终端里跑\d country，查看表的约束列表，确认name字段的UNIQUE约束存在。另外，PostgreSQL对字符串大小写敏感——如果插入的countryName是大小写不同的相同内容（比如"Canada"和"canada"），默认的UNIQUE约束会把它们当成不同值，允许重复插入。要是需要不区分大小写的唯一限制，得建个基于小写转换的唯一索引：

  CREATE UNIQUE INDEX idx_country_name_lower ON country (lower(name));
  

• 用了延迟约束
  如果迁移里创建的是延迟生效的约束（比如CONSTRAINT unique_country_name UNIQUE(name) DEFERRABLE INITIALLY DEFERRED），PostgreSQL会把约束检查延迟到事务提交时才做。要是你的Symfony命令在插入后没提交事务，或者在同一个事务里多次插入后才提交，可能不会立刻抛出异常。不过最终提交事务时还是会触发约束报错，除非你的代码捕获了异常但没做任何提示。

• 空值的特殊情况
  PostgreSQL的UNIQUE约束允许多条记录的name字段为NULL，因为SQL标准里NULL和任何值都不相等（包括另一个NULL）。如果你的重复插入是针对空值的，这属于正常行为。

• 连错数据库了
  检查下Symfony命令用的数据库连接是不是你创建约束的那个库。比如你在生产库加了约束，但命令实际连的是测试库，那约束自然不存在，随便插重复数据都不会报错。

• Doctrine元数据缓存没更新
  要是Doctrine的实体元数据缓存没同步，可能导致代码里的实体映射和实际数据库结构不匹配。跑一下bin/console doctrine:cache:clear-metadata清掉元数据缓存，确保实体层和数据库约束一致。

内容的提问来源于stack exchange，提问作者Mayor of the Plattenbaus