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 替换已匹配的规范化路径前缀。

让后端报告它实际收到的路径
把以下完整程序保存为 path_echo.py,在 Linux 上用 Python 3 执行 python3 path_echo.py。9000 需空闲,终端保持运行:
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 配置。
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/; }
}检查并重载成功后执行:
# 引号保护问号,三个请求只改变 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预期输出:
/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 和后端实际请求目标,能定位到底在哪一层多了一段路径。