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 依然能被携带，兼顾了安全与实用性。

? 必备配置检查（settings.py）

代码写好了，但如果 Django 配置没到位，一切仍是徒劳。请务必检查你的 settings.py，确保以下配置已正确启用：

# settings.py
USE_I18N = True
USE_L10N = True

LANGUAGES = [
    (‘de’, ‘Deutsch’),
    (‘en’, ‘English’),
]
LANGUAGE_CODE = ‘en’  # 这是最后的“保底”语言，仅当以上所有线索都缺失时使用

# 翻译文件路径（记得先创建 locale/ 目录并运行 compilemessages）
LOCALE_PATHS = [BASE_DIR / ‘locale’]

# 中间件顺序至关重要！这是最容易出错的地方。
MIDDLEWARE = [
    ‘django.middleware.security.SecurityMiddleware’,
    ‘django.contrib.sessions.middleware.SessionMiddleware’,  # 必须放在 LocaleMiddleware 之前
    ‘django.middleware.locale.LocaleMiddleware’,            # 语言探测的核心中间件
    ‘django.middleware.common.CommonMiddleware’,
    # … 其他你的中间件
]

配置完成后，如何验证？很简单，打开浏览器的开发者工具，进入 Application 或 Storage 标签页下的 Cookies 选项，查看当前站点下是否出现了一个名为 django_language 的 Cookie，其值就是你刚才选择的 ‘en’ 或 ‘de’。

⚙️ 前端集成建议（React / Axios 场景）

如今前后端分离是主流。如果你的前端是 React 应用，通过 API 接口（如 POST /api/setlang/）来切换语言，就需要额外注意前后端的协同。

• 后端接口需要像上面那样，在响应中正确设置 Set-Cookie 头部。
• 前端发起请求时，必须启用凭据（credentials）发送。以 Axios 为例：

// React 组件中调用语言切换 API
axios.post(‘/api/setlang/’, { lang: ‘de’ }, {
  withCredentials: true, // ✅ 这个选项是关键！否则浏览器不会发送或保存Cookie
}).then(() => window.location.reload()); // 建议刷新页面，让 LocaleMiddleware 立即生效

同时，如果前端应用运行在不同的端口或域名下（即跨域），Django 后端还需要配置 CORS 以允许凭据传递。使用 django-cors-headers 库可以轻松实现：

# settings.py
INSTALLED_APPS += [‘corsheaders’]
# CorsMiddleware 需要尽可能靠前，放在 SessionMiddleware 之前也没问题
MIDDLEWARE.insert(1, ‘corsheaders.middleware.CorsMiddleware’)

CORS_ALLOW_CREDENTIALS = True  # 允许跨域请求携带 Cookie
CORS_ALLOWED_ORIGINS = [‘http://localhost:3000’]  # 替换为你实际的前端开发地址

✅ 总结：三步达成语言持久化

遵循以上三步，用户的语言选择就会被牢牢记住。无论是刷新页面、跳转到站内其他路由，甚至是关闭浏览器后再打开，只要 Cookie 还在有效期内，Django 就会自动加载用户上次选择的语言。这样一来，一个真正“开箱即用”、不依赖用户登录的国际化体验就完美实现了。