Django中IntegrityError错误：auth_user.username唯一约束失败的原因与解决

错误原因 #

这个错误的核心是Django内置的User模型对username字段强制了唯一约束——数据库里不允许出现两个相同的用户名。你的signup视图代码在创建用户前，没有校验输入的用户名是否已经存在，只要用户提交了一个已被注册的用户名，就会触发这个唯一约束冲突，抛出IntegrityError。

解决方法 #

1. 提前校验用户名是否重复（推荐） #

在创建用户前先查询数据库，判断用户名是否已存在，存在则给用户提示并返回注册页面：

from django.shortcuts import redirect, render
from django.contrib.auth.models import User
from django.contrib import messages

def index(request):
    return render(request, "index.html")

def signup(request):
    if request.method == "POST":
        username = request.POST['uname']
        first_name = request.POST['fname']
        last_name = request.POST['lname']
        email = request.POST['email']
        pass1 = request.POST['pass1']
        pass2 = request.POST['pass2']

        # 新增：校验用户名是否已存在
        if User.objects.filter(username=username).exists():
            messages.error(request, "该用户名已被注册，请换一个试试")
            return redirect('signup')
        
        # 额外补充：校验两次密码是否一致（避免后续其他问题）
        if pass1 != pass2:
            messages.error(request, "两次输入的密码不一样，请重新输入")
            return redirect('signup')

        myuser = User.objects.create_user(username=username, password=pass1, email=email)
        myuser.first_name = first_name
        myuser.last_name = last_name
        myuser.save()

        messages.success(request, "账号创建成功，请登录")
        return redirect('login')

    return render(request, "signup.html")

def login(request):
    return render(request, "login.html")

def signout(request):
    pass

2. 捕获异常兜底处理 #

如果不想提前做查询校验，也可以直接捕获IntegrityError异常，给用户返回提示：

from django.shortcuts import redirect, render
from django.contrib.auth.models import User
from django.contrib import messages
from django.db import IntegrityError  # 导入异常类

def signup(request):
    if request.method == "POST":
        username = request.POST['uname']
        first_name = request.POST['fname']
        last_name = request.POST['lname']
        email = request.POST['email']
        pass1 = request.POST['pass1']
        pass2 = request.POST['pass2']

        if pass1 != pass2:
            messages.error(request, "两次输入的密码不一样，请重新输入")
            return redirect('signup')

        try:
            myuser = User.objects.create_user(username=username, password=pass1, email=email)
            myuser.first_name = first_name
            myuser.last_name = last_name
            myuser.save()

            messages.success(request, "账号创建成功，请登录")
            return redirect('login')
        except IntegrityError:
            messages.error(request, "该用户名已被注册，请换一个试试")
            return redirect('signup')

    return render(request, "signup.html")

3. 前端辅助校验（可选优化） #

可以在前端注册表单里加实时校验，比如用AJAX请求后端接口，在用户输入用户名时就检查是否已存在，提前给用户提示，减少后端错误触发的概率。

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