Django表单POST请求遇UnboundLocalError：局部变量未赋值即引用

这个错误其实是Python局部变量的典型问题，结合你描述的场景（Admin能正常注册，用户视图不行），咱们可以一步步拆解原因和解决方案：

错误的核心原因 #

Python要求函数内的局部变量必须在所有可能的代码路径中都完成赋值，才能被使用。如果你的视图里只在某个条件分支（比如POST请求处理）里给nombre赋值，而在其他分支（比如GET请求渲染表单）里没有初始化这个变量，但后面又尝试调用它，就会触发这个错误。

举个你大概率遇到的典型错误场景：

def user_registro(request):
    if request.method == 'POST':
        # 仅在POST请求时获取nombre
        nombre = request.POST.get('nombre')
        form = RegistroForm(request.POST)
        if form.is_valid():
            form.save()
            return redirect('registro_exito')
    # GET请求时，nombre从未被定义，但下面要传给模板
    return render(request, 'registro.html', {'nombre': nombre})

当用户通过GET请求访问页面时，nombre根本没被赋值，但最后却要把它传入模板，直接触发UnboundLocalError。

为什么Admin能正常工作？ #

Django内置的Admin视图逻辑非常严谨，会确保所有必要变量都被正确初始化，而且Admin使用的表单处理流程会覆盖所有代码路径，不会出现变量未定义的情况。这也说明你的models.py和表单定义（如果用了ModelForm）是完全没问题的，问题只出在你自己编写的视图逻辑里。

修复方案 #

针对你的情况，有两种简单且有效的修复思路：

1. 提前初始化变量
   在视图函数的开头，给nombre设置一个默认值，确保所有代码路径都能访问到它：

def user_registro(request):
    nombre = ''  # 或者设为None，根据你的业务需求调整
    if request.method == 'POST':
        nombre = request.POST.get('nombre')
        form = RegistroForm(request.POST)
        if form.is_valid():
            form.save()
            return redirect('registro_exito')
    else:
        form = RegistroForm()
    return render(request, 'registro.html', {'nombre': nombre, 'form': form})

2. 严格控制变量的使用范围
   如果nombre只在POST请求处理时才需要，那确保只有在赋值完成后才使用它。比如把需要用到nombre的代码全部放在if request.method == 'POST'的分支内，避免在未赋值的场景下调用它。

额外检查点 #

• 如果你是手动创建模型对象（而非使用form.save()），要确认所有分支都给对象的nombre属性完成了赋值，避免因分支遗漏导致的变量问题。
• 检查模板中是否渲染了nombre变量，如果GET请求时模板需要这个变量，必须确保视图在GET分支也为它提供有效值。

按照这个思路排查你的views.py，应该能快速定位到未初始化nombre的代码路径并解决问题。

内容的提问来源于stack exchange，提问作者César Montilla