为何调用Django视图时无法设置Cookie？首次提交表单不生效

问题背景 #

通过带复选框的表单设置/取消Django Cookie：勾选复选框时设置Cookie为yes，取消时设为no。目前复选框值能正常传到视图，但首次提交后Cookie看似未生效，页面刷新后复选框未选中；再次提交才正常。

现有代码 #

视图代码 #

def filter(request):

    tasks = list()

    if request.POST.get('today') == 'yes':
        tasks.extend(Task.objects(when='today'))
        print('get tasks today')

    response = render(request, 'index.html', {'tasks': tasks})

    if request.POST.get('today') == 'yes':
         response.set_cookie('today', 'yes')
         print('set cookie today')
    else:
        response.set_cookie('today', 'no')
        print('cookie not set today')

    return response

模板代码 #

{{request.COOKIES.today}}
<form action="filter" method="POST">
    {% csrf_token %}
    <input type="checkbox" name="today" value="yes" {% if request.COOKIES.today == 'yes' %}checked{% endif %}> Today</div>
    <input type="submit" value="Show" class="btn btn-warning col-12 btn-sm"/>
</form>

问题根源 #

Cookie是在服务器返回的响应中设置的，而模板里的request.COOKIES是当前请求携带的Cookie——也就是提交表单前浏览器已有的Cookie。首次提交时，浏览器还没收到新设置的Cookie，所以模板渲染时用request.COOKIES判断复选框状态，拿到的还是旧值（或空），导致页面显示的状态和刚设置的Cookie不匹配，让你误以为Cookie没生效。

实际上首次提交后Cookie已经被设置了，只是页面渲染时没用到本次请求的选择状态。

修复方案 #

步骤1：传递本次请求的选择状态到模板 #

修改视图，把本次请求中复选框的选择状态传给模板，替代直接用request.COOKIES判断：

def filter(request):
    tasks = list()
    # 先确定本次请求的today选择状态
    today_selected = request.POST.get('today') == 'yes'

    if today_selected:
        tasks.extend(Task.objects(when='today'))
        print('get tasks today')

    # 把本次选择状态传给模板
    response = render(request, 'index.html', {
        'tasks': tasks,
        'today_selected': today_selected
    })

    # 设置Cookie
    if today_selected:
         response.set_cookie('today', 'yes')
         print('set cookie today')
    else:
        response.set_cookie('today', 'no')
        print('cookie not set today')

    return response

步骤2：修改模板的复选框判断逻辑 #

模板中同时参考本次请求的选择状态和已有Cookie，确保提交后立即显示正确状态：

{{request.COOKIES.today}} <!-- 可保留用于调试 -->
<form action="filter" method="POST">
    {% csrf_token %}
    <input type="checkbox" name="today" value="yes" 
           {% if today_selected or request.COOKIES.today == 'yes' %}checked{% endif %}> Today
    <input type="submit" value="Show" class="btn btn-warning col-12 btn-sm"/>
</form>

额外优化：处理非POST请求场景 #

如果需要支持首次访问（GET请求）时读取已有Cookie并展示对应状态，可补充请求方法判断：

def filter(request):
    tasks = list()
    today_selected = False

    if request.method == 'POST':
        # POST请求时，取表单提交的状态
        today_selected = request.POST.get('today') == 'yes'
        if today_selected:
            tasks.extend(Task.objects(when='today'))
    else:
        # GET请求时，读取已有Cookie的状态
        today_selected = request.COOKIES.get('today') == 'yes'
        if today_selected:
            tasks.extend(Task.objects(when='today'))

    response = render(request, 'index.html', {
        'tasks': tasks,
        'today_selected': today_selected
    })

    # 仅在POST提交时更新Cookie
    if request.method == 'POST':
        response.set_cookie('today', 'yes' if today_selected else 'no')

    return response

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