Web 服务器与网关 / 系统课时
精确匹配和前缀匹配怎么选
精确匹配和前缀匹配怎么选
健康检查通常只应处理一个路径,接口目录则要覆盖一组子路径。本篇用 /health、/api/ 和 /apiary 的对照,选择精确与前缀规则,并避免把字符串前缀误当成自动识别的目录边界。
学习目标
- 为单一路径选择精确匹配,为路径集合选择前缀匹配。
- 识别有无尾斜杠带来的覆盖范围差异。
- 使用边界请求验证规则没有多匹配或漏匹配。
单一路径使用精确匹配
location = /health 只匹配规范化后恰好为 /health 的路径,查询参数不影响这一判断。/health/ 和 /healthz 都不是相同路径。健康检查、固定验证文件或只允许一个明确入口时,精确规则能把处理范围写得更清楚。
location /api/ 则匹配以 /api/ 开头的路径,包括 /api/orders 和 /api/v1/users。它不匹配 /apiary,也不直接等于没有末尾斜杠的 /api;对后者应明确决定返回什么,而不是依赖读者脑中想象的“目录”。
用响应标记验证边界
片段示例:以下 server 块放入 http 上下文,8080 端口未被另一实例占用。这里不使用代理,因此 /api 不会触发代理型前缀的自动补斜杠行为。
server {
listen 127.0.0.1:8080;
server_name boundary.test;
# 单点健康检查不应吞掉 /healthz 等其他路径。
location = /health { return 200 "healthy\n"; }
location /api/ { return 200 "api-child\n"; }
location / { return 404 "outside\n"; }
}检查并重载后,执行完整验证命令。每次同时输出响应体和状态,便于区分“没有命中”与“命中了但业务报错”。
# 除正常路径外,还测试尾斜杠和相似名称边界。
for path in '/health?full=1' '/health/' '/api/orders' '/api' '/apiary'; do
curl -sS -H 'Host: boundary.test' -w 'status=%{http_code}\n' "http://127.0.0.1:8080$path"
done预期输出:
healthy
status=200
outside
status=404
api-child
status=200
outside
status=404
outside
status=404如果把前缀改为 /api,/apiary 也会命中它,因为普通前缀比较字符串,不自动检查下一字符是不是斜杠。需要同时覆盖裸入口与子路径时,可以使用 location = /api 单独定义裸入口,再保留 /api/ 的子路径规则。
最长前缀与正则仍有区别
| 需求 | 可选规则 | 需要补测 |
|---|---|---|
| 仅一个固定健康路径 | = /health |
/health/、/healthz |
| API 子路径集合 | /api/ |
/api、/apiary |
| 子路径应跳过本层正则 | ^~ /api/ |
/api/logo.png 等重叠路径 |
^~ 不是正则,也不意味着匹配任意字符;它仍是前缀规则,只会在该前缀是最长匹配前缀时影响后续正则检查。多个普通前缀之间由最长匹配者胜出,不能通过把较短前缀放在文件顶部提高优先级。
选择范围不等于访问授权
把管理接口放到一个精确或前缀规则中,不会自动验证访问者身份。目录覆盖范围与认证、网络限制是不同问题;应分别验证正常路径、边界路径和未授权请求。对本节这样的三组简单边界,响应表比增加流程配图更便于逐条核对。