Django用户注册报错：UNIQUE constraint failed: auth_user.username

UNIQUE constraint failed: auth_user.username 这个错误的核心是你要创建的用户名已经在数据库里存在了——Django自带的User模型把username设为了唯一字段，不允许重复值。结合你的代码，还有几个细节问题需要一并修复：

关键修复点 #

• 提前检查用户名是否已存在：在创建用户前先查询数据库，避免重复提交导致约束错误
• 修正请求方法大小写：HTTP请求方法是大写的，request.method == "post"要改成"POST"
• 修复User模型字段名：你代码里写的firstname、lastname是错误的，正确字段为first_name、last_name
• 添加密码一致性验证：注册时检查两次输入的密码是否匹配，避免无效请求

修改后的完整views.py代码 #

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

# Create your views here.
def home(request):
    return render(request, "authentication/index.html")

def signin(request):
    if request.method == "POST":
        username = request.POST['username']
        pass1 = request.POST['pass1']

        user = authenticate(username=username, password=pass1)

        if user is not None:
            login(request, user)
            fname = user.first_name
            # 修正模板路径拼写错误（原代码写的authenticate，应为authentication）
            return render(request, 'authentication/index.html', {'fname': fname})
        else:
            messages.error(request, '账号或密码错误')
            return redirect('home')

    return render(request, "authentication/signin.html")

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

        # 验证两次密码是否一致
        if pass1 != pass2:
            messages.error(request, '两次输入的密码不一致')
            return redirect('signup')
        
        # 检查用户名是否已存在
        if User.objects.filter(username=username).exists():
            messages.error(request, '该用户名已被注册，请更换')
            return redirect('signup')
        
        # 可选：检查邮箱是否已注册（若需要邮箱唯一）
        if User.objects.filter(email=email).exists():
            messages.error(request, '该邮箱已被注册，请更换')
            return redirect('signup')

        # 创建用户，明确指定参数名避免顺序错误
        myuser = User.objects.create_user(username=username, email=email, password=pass1)
        # 修正字段名
        myuser.first_name = fname
        myuser.last_name = lname

        myuser.save()

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

    return render(request, "authentication/signup.html")

def signout(request):
    logout(request)
    messages.success(request, '已成功登出')
    return redirect('home')

额外提示 #

如果想进一步提升用户体验，建议在前端表单添加实时验证（比如用AJAX检测用户名/邮箱是否已存在），提前阻止无效提交。

内容的提问来源于stack exchange，提问作者Ahamad Mamun Nishar Miya