Flask执行db.session.commit()报SQLAlchemy UNIQUE约束失败错误如何解决

• 核心问题来自模型定义错误：你在User类的image_file字段上错误添加了unique=True唯一约束，同时该字段的默认值为固定的default.jpg。当创建多个未自定义头像的用户时，所有新用户的image_file都会默认填充default.jpg，直接触发数据库唯一约束校验失败。
• 测试代码执行顺序不规范：正常流程应该先执行db.create_all()创建表结构，再添加用户数据提交，你当前的顺序是先添加用户到会话再建表，虽然不是本次报错的核心原因，但容易引发会话异常。

1. 修复User模型的字段定义，移除image_file的unique=True约束，修改后的字段代码为：

image_file = db.Column(db.String(20), default='default.jpg')

头像字段本身允许多个用户使用默认头像，不需要设置唯一限制。
2. 删除项目目录下已生成的旧数据库文件site.db，重新执行db.create_all()生成符合新结构的数据库表。
3. 后续测试调整执行顺序，避免会话异常：

# 先创建表结构
db.create_all()
# 再添加用户数据
user_1 = User(username='Corey', email='C@demo.com', password='password')
db.session.add(user_1)
user_2 = User(username='JohnDoe', email='jd@demo.com', password='password')
db.session.add(user_2)
# 最后提交事务
db.session.commit()

4. 如果当前终端会话已经触发回滚报错，先执行db.session.rollback()重置会话状态，再执行后续操作即可。

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