计算机网络 / 系统课时
使用语言协商
使用语言协商
语言协商解决的是“同一个资源有多种语言版本时,该返回哪一个”。客户端用 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;匹配时不要依赖大小写差异。
一次请求可以是:
GET /welcome HTTP/1.1
Host: example.test
Accept-Language: zh-CN, zh;q=0.9, en;q=0.7若服务器选择中文版本,关键响应头应包含:
HTTP/1.1 200 OK
Content-Type: text/plain; charset=utf-8
Content-Language: zh-CN
Vary: Accept-LanguageContent-Language 描述本次表示面向的语言,不是字符编码;UTF-8 仍由 Content-Type 的 charset 参数说明。
用本地服务验证语言选择
下面的 Python 3 服务支持 zh-CN 与 en-US。选择顺序是:先按 q 从高到低尝试精确匹配,再用主语言匹配,最后回退到 en-US。这是一个适合入门项目的明确规则,实际产品还可以加入用户账户语言或 URL 语言前缀。
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()预期输出
listening on http://127.0.0.1:8001保持服务运行,再发送中文优先的请求:
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 会因环境不同而变化,因此省略:
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;否则用默认语言加可见的语言切换入口通常更实用。