如何为Django结账页面表单添加Django Messages必填字段验证

原代码背景 #

现有结账页面的Checkout视图负责渲染表单并生成订单ID，表单提交至placeorder视图处理。当前缺少后端必填字段验证逻辑，导致提交空字段时直接报错，需通过Django Messages实现验证并友好提示用户。

步骤1：确认Django Messages基础配置 #

确保settings.py中已启用Messages功能（默认已配置，若未添加需补充）：

INSTALLED_APPS = [
    # ... 其他已安装应用
    'django.contrib.messages',
]

MIDDLEWARE = [
    # ... 其他中间件
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    # ... 其他中间件
]

步骤2：修改placeorder视图添加验证逻辑 #

表单提交的处理逻辑需放在placeorder视图中，添加必填字段检查，验证失败时用messages.error添加错误提示，并重渲染结账页面保留用户输入：

from django.shortcuts import render, redirect
from django.contrib import messages

def placeorder(request):
    if request.method == 'POST':
        # 获取表单提交的字段
        first_name = request.POST.get('first_name', '').strip()
        last_name = request.POST.get('last_name', '').strip()
        address = request.POST.get('address', '').strip()
        postcode = request.POST.get('postcode', '').strip()
        order_id = request.POST.get('order_id')
        payment = request.POST.get('payment')

        # 执行必填字段验证
        has_error = False
        if not first_name:
            messages.error(request, '名字不能为空')
            has_error = True
        if not last_name:
            messages.error(request, '姓氏不能为空')
            has_error = True
        if not address:
            messages.error(request, '地址不能为空')
            has_error = True
        if not postcode:
            messages.error(request, '邮政编码不能为空')
            has_error = True

        # 验证失败，返回结账页面并保留原有上下文数据
        if has_error:
            cart = request.session.get('cart')
            tax = sum(i.get('tax', 0) for i in cart.values() if i)
            context = {
                'tax': tax,
                'order_id': order_id,
                'payment': payment,
                'user': request.user,
                # 保留用户已输入的内容，提升体验
                'post_address': address,
                'post_postcode': postcode
            }
            return render(request, 'checkout/checkout.html', context)
        
        # 验证通过，执行后续下单逻辑（保存订单、处理支付等）
        # ... 你的业务代码
        
        # 下单成功后跳转至成功页面
        messages.success(request, '订单提交成功')
        return redirect('order_success')

    # GET请求直接重定向至结账页面
    return redirect('checkout')

步骤3：修改HTML模板显示错误消息 #

在结账页面的表单上方添加消息展示区域，同时为输入框保留用户已输入内容：

<div class="container">
    <!-- 显示Django Messages提示 -->
    {% if messages %}
        {% for message in messages %}
            <div class="alert alert-danger alert-dismissible fade show" role="alert">
                {{ message }}
                <button type="button" class="btn-close" data-bs-dismiss="alert" aria-label="Close"></button>
            </div>
        {% endfor %}
    {% endif %}

    <form method="post" action="{% url 'placeorder' %}">
        {% csrf_token %}
        <div class="row">
            <div class="col-lg-6">
                <div class="checkbox-form mt-30">
                    <h3>Billing Details</h3>
                    <div class="row">
                        
                        <div class="col-md-6">
                            <div class="checkout-form-list">
                                <label>First Name <span class="required">*</span></label>
                                <input type="text" value="{{user.first_name}}" name="first_name" placeholder="" readonly>
                                <input type="text" value="{{order_id}}" name="order_id" placeholder="" hidden>
                                <input type="text" value="{{payment}}" name="payment" placeholder="" hidden>
                            </div>
                        </div>
                        <div class="col-md-6">
                            <div class="checkout-form-list">
                                <label>Last Name <span class="required">*</span></label>
                                <input type="text" value="{{user.last_name}}" name="last_name" placeholder="" readonly>
                            </div>
                        </div>
                        
                        <div class="col-md-12">
                            <div class="checkout-form-list">
                                <label>Address <span class="required">*</span></label>
                                <input type="text" name="address" placeholder="Street address" value="{{ post_address }}">
                            </div>
                        </div>
                        <div class="col-md-6">
                            <div class="checkout-form-list">
                                <label>Postcode / Zip <span class="required">*</span></label>
                                <input type="text" name="postcode" placeholder="Postcode / Zip" value="{{ post_postcode }}">
                            </div>
                        </div>
                        <!-- 其他表单字段及提交按钮 -->
                        <div class="col-md-12 mt-3">
                            <button type="submit" class="btn btn-primary">继续</button>
                        </div>
                    </div>
                </div>
            </div>
        </div>
    </form>
</div>

模板修改说明：

• 添加消息展示区块，用alert样式显示错误提示（可根据你的模板风格调整样式）
• 为地址、邮政编码输入框绑定value属性，验证失败时保留用户已输入内容，避免重复输入

核心注意事项 #

• 后端验证是防止非法提交的关键，前端required属性仅做基础提示，不能替代后端验证
• messages模块会自动将提示信息存储在session中，无需手动管理
• 验证失败时需重新传递原有上下文数据（订单ID、支付信息等），保证页面正常渲染

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