访问/accounts/register/注册路径触发UnboundLocalError错误问题咨询

核心原因说明 #

UnboundLocalError的本质是代码引用了还未完成赋值的局部变量，结合你描述的注册功能场景，该问题几乎都是由于视图或表单校验代码的分支逻辑不完善导致的：访问/accounts/register/路径默认是GET请求，此时某段代码中只在POST请求分支赋值的变量被直接引用。

排查步骤 #

• 优先检查views.py的注册视图逻辑：
  1. 确认是否仅在if request.method == "POST":代码块内初始化了表单实例，GET分支没有做表单初始化，但是最终返回响应时直接把表单变量传给了模板
  2. 确认是否有自定义校验结果类的变量，仅在POST请求的手机号校验逻辑里赋值，但是在条件分支外直接引用了该变量
• 其次检查forms.py的手机号校验方法：
  确认clean_手机号字段名的自定义校验方法中，是否只有手机号已存在的分支给变量赋值，手机号不存在的分支没有给对应变量赋值就直接引用。

典型场景修复方案 #

视图层常见错误修复 #

错误写法示例（GET请求时form变量未赋值直接引用）：

def register(request):
    if request.method == "POST":
        form = RegisterForm(request.POST)
        # 后续校验、保存逻辑
    # 直接在分支外引用form变量，GET请求时form不存在
    return render(request, "register.html", {"form": form})

对应修复写法：

def register(request):
    if request.method == "POST":
        form = RegisterForm(request.POST)
        if form.is_valid():
            # 保存用户、跳转逻辑
            return redirect("登录路由名")
    else:
        # GET请求时初始化空表单
        form = RegisterForm()
    return render(request, "register.html", {"form": form})

表单校验层常见错误修复 #

错误写法示例（手机号不存在时msg变量未赋值直接引用）：

def clean_mobile(self):
    mobile = self.cleaned_data.get("mobile")
    if User.objects.filter(mobile=mobile).exists():
        msg = "该手机号已注册"
    raise forms.ValidationError(msg)

对应修复写法：

def clean_mobile(self):
    mobile = self.cleaned_data.get("mobile")
    if User.objects.filter(mobile=mobile).exists():
        raise forms.ValidationError("该手机号已注册")
    # 校验通过返回字段值
    return mobile

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