FastAPI注册接口报422错误：username违反UNIQUE约束

问题根源 #

UNIQUE constraint failed: user.username 明确说明你要创建的用户名已经在数据库中存在——你的User模型里username字段设置了唯一约束（unique=True），数据库不允许重复值，FastAPI将数据库抛出的这个异常转化成了422 Unprocessable Entity响应。

具体解决步骤 #

• 先验证请求数据：在/docs界面调用接口时，更换一个从未使用过的用户名提交请求，确认是否能正常注册，这是最快排查问题的方法。
• 添加前置校验逻辑：在调用User.create()之前，先查询数据库是否存在该用户名，提前拦截重复请求并返回友好错误：

  # 在第86行`user_obj = await User.create(**user_info)`之前添加
  existing_user = await User.query.where(User.username == user_info["username"]).gino.first()
  if existing_user:
      from fastapi import HTTPException
      raise HTTPException(status_code=400, detail="用户名已存在，请更换")
  user_obj = await User.create(**user_info)
  

• 清理测试数据：如果是测试环境重复调用导致的问题，直接删除数据库中已存在的重复用户名记录，避免后续测试被干扰。

额外优化 #

给User模型的username字段添加索引，提升查询效率，尤其是用户量变大后，前置校验的查询会更快：

class User(db.Model):
    # 其他字段...
    username = db.Column(db.String, unique=True, index=True, nullable=False)

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