# SQLAlchemy 完整性错误：(sqlite3.IntegrityError) 唯一约束失败：users.username

- **ID:** `python/flask-sqlalchemy-integrity-error`
- **领域:** python
- **类别:** data_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

尝试插入重复的用户名，违反了数据库的唯一约束

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.9 | active | — | — |
| 3.10 | active | — | — |

## 解决方案

1. **在插入前检查用户名是否已存在** (90% 成功率)
   ```
   if User.query.filter_by(username=username).first():
    return '用户名已存在', 400
   ```
2. **使用 try-except 捕获并返回友好错误** (95% 成功率)
   ```
   try:
    db.session.add(user)
    db.session.commit()
except IntegrityError:
    db.session.rollback()
    return '用户名已存在', 400
   ```

## 无效尝试

- **捕获异常后直接忽略** — 用户不会收到错误提示，数据未保存 (90% 失败率)
- **删除唯一约束而不数据清洗** — 可能导致数据混乱 (70% 失败率)