Django表单验证错误仅在控制台显示，网页无法展示的问题求助

1. 先修正视图函数（views.py）的逻辑 #

你看到错误在GET响应里出现，大概率是视图初始化表单的逻辑错了——GET请求时就用request.POST创建了表单，空的POST数据触发了验证错误。

错误写法（会导致GET请求带错误）： #

def register(request):
    # 错在这：GET请求就用POST数据初始化表单，空数据直接触发验证失败
    form = UserRegistrationForm(request.POST)
    if request.method == 'POST':
        if form.is_valid():
            form.save()
            return redirect('home')
    return render(request, 'register.html', {'form': form})

正确写法： #

def register(request):
    if request.method == 'POST':
        # 只有POST请求才用提交的数据初始化表单
        form = UserRegistrationForm(request.POST)
        if form.is_valid():
            form.save()
            return redirect('home')
        # 表单无效时，直接带着错误返回页面
    else:
        # GET请求创建空表单，不会触发验证
        form = UserRegistrationForm()
    return render(request, 'register.html', {'form': form})

2. 检查HTML模板的错误渲染逻辑 #

新手常漏写错误遍历，或者只处理了字段错误没处理全局错误，以下是完整的表单错误渲染示例：

<form method="POST">
    {% csrf_token %}
    <!-- 显示全局非字段错误（比如密码不匹配这类自定义全局验证） -->
    {% if form.non_field_errors %}
        <div class="error-msg">
            {% for error in form.non_field_errors %}
                <p>{{ error }}</p>
            {% endfor %}
        </div>
    {% endif %}

    <!-- 遍历每个字段，显示字段专属错误 -->
    {% for field in form %}
        <div class="form-item">
            {{ field.label_tag }}
            {{ field }}
            {% if field.errors %}
                <div class="text-red">
                    {% for error in field.errors %}
                        <small>{{ error }}</small>
                    {% endfor %}
                </div>
            {% endif %}
        </div>
    {% endfor %}

    <button type="submit">注册</button>
</form>

注意：

• 必须加{% csrf_token %}，否则POST请求会被Django拦截，你可能误以为是错误渲染问题
• 要同时处理form.non_field_errors和field.errors两种错误类型

3. 确认forms.py的自定义验证逻辑 #

别只把错误print到控制台，要把错误注册到表单的错误字典里，模板才能拿到：

from django import forms
from .models import User

class UserRegistrationForm(forms.ModelForm):
    password = forms.CharField(widget=forms.PasswordInput)
    confirm_password = forms.CharField(widget=forms.PasswordInput)

    class Meta:
        model = User
        fields = ['username', 'email', 'password']

    def clean(self):
        cleaned_data = super().clean()
        password = cleaned_data.get('password')
        confirm_pwd = cleaned_data.get('confirm_password')

        if password != confirm_pwd:
            # 把错误注册到表单，而不是只print
            self.add_error(None, "两次密码输入不一致")
            # 也可以绑定到具体字段：self.add_error('confirm_password', "密码不匹配")
        return cleaned_data

内容的提问来源于stack exchange，提问作者Connor.Ryan-UC