Web 服务器与网关 / 系统课时

proxy_pass 尾斜杠为什么重要

proxy_pass 尾斜杠为什么重要

同一个 /api/users 请求,后端可能看到 /api/users,也可能只看到 /users。本篇用回显服务实测三种 proxy_pass 写法,让你根据后端的路由约定选择配置,避免凭斜杠外观猜测路径。

学习目标

  • 区分上游地址后没有 URI、URI 为 /、URI 为 /v1/ 三种写法。
  • 用后端回显结果验证路径与查询参数。
  • 识别正则 location、变量和重写会改变基本规则的情况。

看 URI 部分,不只数斜杠

在普通前缀 location /api/ 中,proxy_pass http://127.0.0.1:9000; 没有 URI 部分;http://127.0.0.1:9000/ 的 URI 是 /;http://127.0.0.1:9000/v1/ 的 URI 是 /v1/。后两种会用这个 URI 替换已匹配的规范化路径前缀。

三个相同请求分别保留前缀、移除前缀和替换为 v1 前缀

让后端报告它实际收到的路径

把以下完整程序保存为 path_echo.py,在 Linux 上用 Python 3 执行 python3 path_echo.py。9000 需空闲,终端保持运行:

python
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer

class Echo(BaseHTTPRequestHandler):
    def do_GET(self):
        # self.path 包含查询字符串,直接观察上游收到的请求目标。
        payload = (self.path + "\n").encode()
        self.send_response(200)
        self.send_header("Content-Length", str(len(payload)))
        self.end_headers()
        self.wfile.write(payload)

if __name__ == "__main__":
    ThreadingHTTPServer(("127.0.0.1", 9000), Echo).serve_forever()

预期结果:程序等待连接;直接请求 /users?id=7 时响应状态为 200,正文为 /users?id=7。这是测试回显,不负责查询真实用户。

用三个站点隔离三种写法

以下片段示例整体放入 http 上下文,三个站点共享本机 8080,通过 Host 区分;依赖上述回显服务。这样每次都请求 /api/users?id=7,只改变待比较的 proxy_pass 配置。

nginx
server {
    listen 127.0.0.1:8080;
    server_name keep.test;
    location /api/ {
        # 无 URI:本例保留原始请求目标。
        proxy_pass http://127.0.0.1:9000;
    }
}
server {
    listen 127.0.0.1:8080;
    server_name drop.test;
    location /api/ { proxy_pass http://127.0.0.1:9000/; }
}
server {
    listen 127.0.0.1:8080;
    server_name v1.test;
    location /api/ { proxy_pass http://127.0.0.1:9000/v1/; }
}

检查并重载成功后执行:

bash
# 引号保护问号,三个请求只改变 Host。
for site in keep.test drop.test v1.test; do
  curl -sS -H "Host: $site" 'http://127.0.0.1:8080/api/users?id=7'
done

预期输出:

text
/api/users?id=7
/users?id=7
/v1/users?id=7

后端定义 /api/users 时选第一种;定义 /users 时选第二种;定义 /v1/users 时选第三种。/api/ 包含尾斜杠,匹配的是路径边界;不要把它改成 /api 后仍按相同前缀长度计算。

把路径替换与客户端跳转分开查

请求 /api 时,代理型 /api/ location 可能先返回补斜杠的 301,后端此时尚未收到这次原请求。请求 /api/users 时发生的前缀替换则是在代理内部,不会要求浏览器先打开另一个 URL。

上表只覆盖未重写、无变量的普通前缀配置。正则 location 和命名 location 中无法按同样方式确定待替换前缀,通常应使用不带 URI 的 proxy_pass;在 rewrite ... break 或带变量的 proxy_pass 中也不能直接照搬上表。遇到这些配置,先看官方规则,再用回显服务核对。

本例保留 id=7,并不表示代理永远不能修改查询字符串。排错时同时记录客户端请求目标、配置中的 URI 和后端实际请求目标,能定位到底在哪一层多了一段路径。

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

目录与阅读设置

阅读设置

17

记录一个想法

proxy_pass 尾斜杠为什么重要

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

登录哪都通