SQLAlchemy搭配pgAdmin4时唯一列允许重复，创建第二个重复项才触发约束报错

可能原因 #

这种重复插入两次才触发唯一约束的异常，大概率是以下两种情况：

• 邮箱字段存在隐形字符：比如前后空格、全角空格、换行符等，肉眼看起来完全相同，但数据库判定为不同值
• 数据库未正确创建唯一约束：SQLAlchemy的unique=True可能因某种原因未在PostgreSQL中生成对应的唯一约束

排查步骤 #

1. 验证数据库实际数据
   执行以下SQL查询，检查邮箱的真实内容：

SELECT email, octet_length(email), trim(email) FROM users;

• 若octet_length(email)结果不同，说明两个邮箱存在隐形字符
• 若trim(email)结果相同但原email不同，说明字段前后有空格

2. 确认唯一约束是否存在
   在pgAdmin中查看users表的「约束」标签，或执行SQL查询：

SELECT conname FROM pg_constraint 
WHERE conrelid = 'users'::regclass AND contype = 'u';

如果返回结果中没有针对email的唯一约束，说明表创建时约束未生效，需要重新生成表结构。

解决办法 #

1. 处理隐形字符
   • 在业务代码中插入用户前，强制对邮箱做trim处理：email = email.strip()
   • 或者修改模型，在数据库层面自动trim：

     email = Column(String, nullable=False, unique=True, 
                    server_default=text("trim(''::text)"),
                    server_onupdate=text("trim(email)"))
     

2. 重建唯一约束
   如果确认约束不存在，可以手动在pgAdmin中添加唯一约束，或重新执行SQLAlchemy的表生成逻辑（确保Base.metadata.create_all()正确执行）。

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