Web 服务器与网关 / 系统课时
掌握 location 匹配
掌握 location 匹配
本节解决 Nginx 请求为什么进入错误处理块的问题。通过理解 location 的匹配类型和执行顺序,可以准确控制静态文件、接口代理和特殊路径的请求分发。
学习目标
- 掌握精确匹配、前缀匹配和正则匹配的区别。
- 理解 Nginx location 的实际选择流程。
- 能够通过配置调整请求路由结果。
理解 location 匹配类型
Nginx 的 location 用于根据 URI 路径选择处理逻辑。常见类型包括精确匹配、普通前缀匹配、优先前缀匹配和正则匹配。
匹配规则不是简单的从上到下读取,而是按照 Nginx 定义的优先级计算最终结果。
掌握匹配顺序
location 的核心选择顺序如下:先检查精确匹配 =,再寻找最长普通前缀匹配;如果最长前缀没有使用 ^~,Nginx 会继续检查正则匹配;最后使用普通前缀结果。下面配置展示不同 location 的选择关系。
nginx
server {
listen 80;
location = /health {
return 200 "exact";
}
location ^~ /static/ {
root /data;
}
location ~ \\.php$ {
return 200 "php";
}
location / {
return 200 "default";
}
}预期结果
text
请求 /health 返回 exact。
请求 /static/app.js 使用 /static/ 前缀规则。
请求 /index.php 匹配 php 正则规则。
其他请求进入 /。使用验证请求定位问题
排查 location 错误时,应先确认实际请求 URI,再逐层减少配置范围。可以通过临时返回文本快速确认请求进入哪个块。
bash
curl -i http://example.com/health预期结果
text
HTTP/1.1 200 OK
exact这种验证方式比直接查看页面结果更容易定位路由问题。
常见匹配陷阱
普通前缀 location 不会阻止后续正则匹配。例如 /images/ 可能先被找到,但如果存在匹配 .jpg 的正则规则,最终可能进入正则 location。
如果希望某个目录完全由前缀规则处理,可以使用 ^~。它告诉 Nginx 找到该前缀后不再继续检查正则规则。
另一个常见问题是路径尾部差异。location /api/ 和 location /api 匹配范围不同,设计 API 路由时需要明确是否包含尾部斜杠。
配置调整与验证流程
修改 location 后建议执行以下步骤:
- 使用
nginx -t检查语法。 - 使用 reload 平滑加载配置。
- 使用代表性 URI 请求验证进入结果。
按自己的节奏,确认真正理解。