Nginx反向代理子路径时a标签相对路径跳转异常如何解决

相对链接的解析逻辑完全由浏览器控制，和Nginx后端的反向代理规则没有关系。浏览器解析href="about-us"这类相对路径时，会基于当前地址栏的URL层级拼接：如果当前地址是sample.com/，浏览器默认当前处于根路径，拼接结果就是sample.com/about-us，不会自动补上你后端反代用的/zh/前缀。

按改造成本从低到高排序：

• 方案1：Nginx直接替换响应内容（零业务代码改动）
  依赖Nginx自带的ngx_http_sub_module模块，在响应返回给用户前，自动把HTML里的链接、资源路径补上/zh/前缀，同时修正重定向头，参考配置：

  location / {
      proxy_pass http://你的后端服务IP:端口/zh/;
      # 修正后端返回的3xx重定向地址
      proxy_redirect ~^/zh/(.*)$ /$1;
      # 替换页面内的根路径引用
      sub_filter 'href="/' 'href="/zh/';
      sub_filter 'src="/' 'src="/zh/';
      sub_filter 'action="/' 'action="/zh/';
      # 关闭单次替换限制，解压响应保证替换生效
      sub_filter_once off;
      sub_filter_types text/html text/css application/javascript;
      proxy_set_header Accept-Encoding "";
  }
  

  注意：如果是前端history模式的单页应用，需要额外加路由兜底规则，避免页面刷新404。

• 方案2：调整代理规则，显式暴露路径前缀（最符合URL规范）
  不要做根路径到子路径的隐式反代，直接把根路径做302跳转到/zh/，让浏览器地址栏始终保留/zh/前缀，相对链接会自动正确拼接：

  location = / {
      return 302 /zh/;
  }
  location /zh/ {
      proxy_pass http://你的后端服务IP:端口/zh/;
      # 常规反向代理配置即可，不需要额外替换内容
  }
  

  这种方案没有内容替换的性能损耗，也不会出现部分路径替换遗漏的问题，长期维护成本最低。

• 方案3：业务层配置基础路径（最稳定无兼容问题）
  如果站点用前端框架、CMS系统搭建，直接在项目配置里指定基础路径为/zh/，系统生成的所有链接、静态资源路径都会自动带上前缀，不需要Nginx做额外处理：

  比如Vue/React项目构建时配置publicPath/base为/zh/，WordPress等后台程序直接在站点设置里把站点地址改为sample.com/zh/即可。

内容的提问来源于stack exchange，提问作者IVAN WONG