Web 服务器与网关 / 系统课时
location 是怎样匹配请求路径的
location 是怎样匹配请求路径的
同一个站点里的首页、接口和图片可以使用不同处理规则。本篇用返回标记替代真实业务,观察精确、前缀和正则 location 怎样选择处理者,再解释查询参数为何不会改变本例的匹配结果。
学习目标
- 区分精确、前缀和正则路径规则。
- 按匹配顺序判断平铺 location 的处理结果。
- 用带查询参数的请求验证路径与参数的边界。
先选站点,再选路径
本例适用于 Linux 上的 Nginx 1.28 系列及兼容配置,所有 location 都直接放在同一个 server 中,不涉及嵌套规则。连接地址和 Host 先选择站点,再在该站点内选择路径处理规则;别的站点即使配置了相同路径,也不参与本次选择。
匹配使用规范化后的 URI 路径,不包含查询字符串。例如 /health?full=1 的匹配路径仍是 /health;百分号编码、相对路径分量和重复斜杠也可能在规范化时变化。路由条件若依赖查询参数,应显式处理参数,不能把 ?full=1 直接拼到普通路径规则后面。
理解平铺规则的选择顺序
若存在完全命中的 location =,立即使用它;否则记住最长匹配前缀。若该最长前缀带 ^~,跳过本层正则检查;否则按配置顺序检查正则,首个命中者生效,没有正则命中时回到之前记住的前缀。location 文档定义了这些修饰符。

普通前缀之间比较的是长度,不是书写顺序;正则之间才比较先后。规则变多时先用具体路径手工推演,再发送请求观察标记,比尝试反复调整块的位置更容易定位原因。
用三个响应观察匹配
片段示例:把这个 server 块放入 http 上下文或其 include 的站点文件。固定响应让实验不依赖文件和上游服务;8080 端口应由这份配置独占监听。
server {
listen 127.0.0.1:8080;
server_name route.test;
# 精确规则仅处理规范化路径 /health。
location = /health { return 200 "exact-health\n"; }
location /api/ { return 200 "api-prefix\n"; }
# Linux 本例区分大小写,只有小写 .png 命中这里。
location ~ \.png$ { return 200 "png-regex\n"; }
location / { return 200 "fallback\n"; }
}保存、检查并重载后,在本机执行:
# 查询字符串保留在请求中,但不参与 location 路径匹配。
for path in '/health?full=1' '/api/orders' '/api/logo.png' '/unknown'; do
curl -sS -H 'Host: route.test' "http://127.0.0.1:8080$path"
done预期输出:
exact-health
api-prefix
png-regex
fallback四次状态均应为 200。第三次先记住 /api/,但随后正则命中,因此最终使用图片规则。若 API 下的所有路径都应固定进入接口处理,可以评估 ^~ /api/,并补测那些本来希望由正则处理的资源。
匹配完成还可能再次跳转
本例中的 return 直接结束请求,容易观察一次选择。真实配置里的 index、try_files 和 rewrite 可能触发内部跳转,让后续处理再次选择 location;第一次命中的前缀不一定是最终返回内容的规则。排查复杂配置时还应记录最终 URI 和实际响应。