Django多语言切换持久化实现Cookie与会话协同方案详解

Django 默认的 activate() 函数仅在线程生命周期内生效，无法持久保存语言偏好；本文详解如何通过设置 LANGUAGE_COOKIE、配合 LocaleMiddleware 和正确中间件顺序，实现跨页面、跨刷新的语言选择持久化，并兼容 React 前端场景。

在 Django 项目中实现多语言切换，一个常见的“坑”是：用户明明选择了英文，刷新一下页面，却又变回了默认的德语。问题根源在于，很多人误用了 activate(‘en’) 函数。这个函数其实只作用于当前请求线程，一旦响应结束，它的效果就烟消云散了。下次请求到来时，Django 的语言探测机制会从头开始，按照既定优先级重新判断，结果往往就是用户的选择被“遗忘”，页面又回到了起点。

那么，如何让 Django “记住”用户的每一次选择呢？关键在于理解其内置的 LocaleMiddleware 是如何工作的，并为其提供一份持久化的“记忆载体”。

✅ 正确方案：利用 LANGUAGE_COOKIE 实现自动持久化

想让语言设置“粘住”用户，就得顺着 Django 的设计思路来。LocaleMiddleware 在处理每个请求时，会严格按照以下优先级来探测用户的语言偏好：

1. URL 路径前缀（例如 /en/about/，这需要启用 i18n_patterns）
2. 会话（Session）中的 django_language 键（前提是启用了会话中间件）
3. Cookie 中的 django_language 键（也就是 settings.LANGUAGE_COOKIE_NAME，默认就叫 ‘django_language’）
4. 浏览器的 Accept-Language 请求头
5. 最后，才是回退到 settings.LANGUAGE_CODE 中定义的全局默认语言。

看明白这个顺序，方案就清晰了。对于无需用户登录的站点，设置一个语言 Cookie 是最轻量、最直接且最可靠的持久化方法。它独立于登录状态，只要浏览器不清理，就能一直生效。

具体怎么做？下面是一个视图函数的示例：

# views.py
from django.conf import settings
from django.http import HttpResponseRedirect
from django.urls import reverse
from django.utils.translation import get_language
import logging

logger = logging.getLogger(__name__)

def setlang(request):
    current_lang = get_language()
    target_lang = ‘en’ if current_lang == ‘de’ else ‘de’

    # 核心操作：在响应对象上设置语言 Cookie
    response = HttpResponseRedirect(reverse(‘index’))
    response.set_cookie(
        key=settings.LANGUAGE_COOKIE_NAME,
        value=target_lang,
        max_age=settings.SESSION_COOKIE_AGE, # 有效期与会话Cookie一致
        httponly=True,
        samesite=‘Lax’  # 推荐设置：平衡安全性与前端跳转需求
    )
    return response

⚠️ 几个关键注意事项：

• 别再用 redirect() 加 activate() 的组合拳了。activate() 只影响当前线程，对后续请求毫无作用。
• Cookie 必须在 HttpResponse 对象上设置，并且要在返回响应之前完成。
• 将 samesite 属性设为 ‘Lax’，是个好习惯。这能确保在大多数安全的跨站场景（比如用户从外部邮件点击链接回来）下，Cookie 依然能被携带，兼顾了安全与实用性。