nginx多语言301重定向应基于请求路径前缀(如/en/、/zh/)而非accept-language头;用location ^~ /lang/配合return 301或rewrite提取子路径,确保保留查询参数并避免前缀重复;根路径跳转用location = /;禁用if防止循环和性能问题。

多语言站点中用 Nginx 做 301 重定向,核心是识别请求中的语言前缀(如 /en/、/zh/、/ja/),再按规则映射到对应语言的新路径或新域名,同时保留子路径和查询参数。不能靠浏览器语言头($http_accept_language)做 301 —— 那是动态判断,不适合永久跳转,也不利于 SEO 权重传递。
按语言前缀做路径级重定向(同域名内结构调整)
适用于旧站所有语言页都带前缀,且新结构仍保留在同一域名下(如从 /en/blog/ → /en/articles/):
- 用
location ^~ /en/这类前缀匹配,避免正则开销; - 用
return 301直接跳转,拼接新路径 +$request_uri; - 注意:匹配路径含前缀,但跳转目标里要替换掉旧前缀,否则会重复(比如
/en/en/articles/)。
示例配置:
location ^~ /en/ {
return 301 https://example.com/articles$request_uri;
}
location ^~ /zh/ {
return 301 https://example.com/zhihuang$request_uri;
}
说明:$request_uri 是完整 URI(含 /en/blog/post?id=1),所以跳转后是 https://example.com/articles/en/blog/post?id=1 —— 若你希望去掉前缀,就得用 rewrite 提取子路径:
location ^~ /en/ {
rewrite ^/en/(.*)$ /articles/$1 permanent;
}
按语言前缀跳转到不同语言子域名
常见于将 /en/xxx 永久导向 en.example.com/xxx,需确保子域名已配置好并可访问:
- 每个语言前缀单独写一个
location块,不混用; - 目标地址必须写死协议+子域名+路径,不要依赖变量拼错;
- 务必测试
/?ref=test类参数是否完整保留。
示例:
location ^~ /en/ {
rewrite ^/en/(.*)$ https://en.example.com/$1 permanent;
}
location ^~ /ja/ {
rewrite ^/ja/(.*)$ https://ja.example.com/$1 permanent;
}
处理无前缀默认语言的跳转(如根路径 / → /zh/)
用户访问 https://example.com/ 时,你想把它 301 到中文版首页,但又不能影响其他语言前缀的请求:
- 用
location = /精确匹配根路径; - 直接
return 301 /zh/或完整 URL; - 不要用
if ($uri = "/")——if在 location 外易出错,且 Nginx 官方不推荐。
配置示例:
location = / {
return 301 /zh/;
}
# 同时确保 /zh/ 本身不被二次跳转(即它应是有效入口)
location ^~ /zh/ {
# 正常代理或 serve,不加 return
proxy_pass http://backend_zh;
}
避免常见陷阱
多语言重定向容易踩坑,尤其在 SEO 场景下:
- 别用
if匹配语言前缀 —— 性能差、逻辑难维护、可能触发循环; - 别漏掉
$request_uri或错误写成$uri(后者不含参数); - 多个
location块顺序很重要:更具体的路径(如= /en/contact)应放在通用前缀(^~ /en/)之前,否则会被覆盖; - HTTPS 强制跳转要单独配置 HTTP server 块,不要和语言跳转混在一个块里。











