计算机网络 / 系统课时

使用语言协商

使用语言协商

语言协商解决的是“同一个资源有多种语言版本时,该返回哪一个”。客户端用 Accept-Language 按优先级表达语言偏好,服务器选择一个实际版本,并用 Content-Language 标明返回内容面向的语言。本课用 zh-CN 与 en-US 两个版本跑通一次协商,并处理缓存和回退。

学习目标

  • 看懂带 q 权重的 Accept-Language,并按优先级选择语言。
  • 正确设置 Content-Language 与 Vary: Accept-Language。
  • 设计“精确匹配、主语言回退、默认语言”的可检查规则。

语言优先级怎么读

Accept-Language 使用语言范围和可选的 q 权重,q 默认是 1,范围通常为 0 到 1。例如 zh-CN, zh;q=0.9, en;q=0.7 表示优先简体中文中国区域,其次其他中文,再其次英语。语言标签通常采用 BCP 47 形式,如 zh-CN、en-US;匹配时不要依赖大小写差异。

一次请求可以是:

text
GET /welcome HTTP/1.1
Host: example.test
Accept-Language: zh-CN, zh;q=0.9, en;q=0.7

若服务器选择中文版本,关键响应头应包含:

text
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Content-Language: zh-CN
Vary: Accept-Language

Content-Language 描述本次表示面向的语言,不是字符编码;UTF-8 仍由 Content-Type 的 charset 参数说明。

用本地服务验证语言选择

下面的 Python 3 服务支持 zh-CN 与 en-US。选择顺序是:先按 q 从高到低尝试精确匹配,再用主语言匹配,最后回退到 en-US。这是一个适合入门项目的明确规则,实际产品还可以加入用户账户语言或 URL 语言前缀。

python
from http.server import BaseHTTPRequestHandler, HTTPServer

SUPPORTED = {
    "zh-cn": ("zh-CN", "你好,HTTP!\n"),
    "en-us": ("en-US", "Hello, HTTP!\n"),
}

def parse_languages(header: str):
    items = []
    for order, item in enumerate(header.split(",")):
        parts = [part.strip() for part in item.split(";")]
        tag = parts[0].lower()
        q = 1.0
        for part in parts[1:]:
            if part.startswith("q="):
                q = float(part[2:])
        if q > 0:
            items.append((tag, q, order))
    return sorted(items, key=lambda x: (-x[1], x[2]))

def choose_language(header: str):
    for tag, _, _ in parse_languages(header):
        if tag == "*":
            return SUPPORTED["en-us"]
        if tag in SUPPORTED:
            return SUPPORTED[tag]

        primary = tag.split("-")[0]
        for key, value in SUPPORTED.items():
            if key.split("-")[0] == primary:
                return value

    return SUPPORTED["en-us"]

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        lang, text = choose_language(self.headers.get("Accept-Language", ""))
        body = text.encode("utf-8")

        self.send_response(200)
        self.send_header("Content-Type", "text/plain; charset=utf-8")
        self.send_header("Content-Language", lang)
        self.send_header("Vary", "Accept-Language")
        self.send_header("Content-Length", str(len(body)))
        self.end_headers()
        self.wfile.write(body)

print("listening on http://127.0.0.1:8001")
HTTPServer(("127.0.0.1", 8001), Handler).serve_forever()

预期输出

text
listening on http://127.0.0.1:8001

保持服务运行,再发送中文优先的请求:

bash
curl -i -H "Accept-Language: zh-CN,zh;q=0.9,en;q=0.7" http://127.0.0.1:8001/

预期结果中应出现以下关键内容;Date、Server 与 Content-Length 会因环境不同而变化,因此省略:

text
HTTP/1.0 200 OK
Content-Type: text/plain; charset=utf-8
Content-Language: zh-CN
Vary: Accept-Language

你好,HTTP!

把请求头改成 en-US,en;q=0.9 时,响应应改为 Content-Language: en-US,正文为 Hello, HTTP!,这样就能确认选择逻辑确实由请求偏好驱动。

回退与缓存怎么设计

不要把“不支持某个地区标签”直接等同于“不支持这门语言”。例如只提供 zh-CN 时,收到 zh-TW,zh;q=0.8,en;q=0.5 可以先尝试精确匹配 zh-TW,失败后再按产品规则考虑通用 zh;如果内容差异涉及术语、法规或地区文化,则不应强行把所有中文地区合并。

服务器根据 Accept-Language 改变表示时,应发送 Vary: Accept-Language。但语言组合很多,直接按完整请求头建缓存键会降低命中率。内容站常把语言固定到 /zh-CN/...、/en-US/... 这类 URL,并让首次访问做语言选择;这样缓存键更稳定,也方便用户复制一个不会随浏览器偏好变化的链接。

对于没有匹配语言的请求,HTTP 允许返回 406 Not Acceptable,但大多数站点更适合返回明确的默认语言,并正确标注 Content-Language。如果产品要求“绝不能用错误语言代替”,再考虑 406;否则用默认语言加可见的语言切换入口通常更实用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用语言协商

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通