精准匹配使用=修饰符，要求URI路径完全一致（含大小写、末尾斜杠），不匹配查询参数；优先级最高，命中即终止后续匹配；常用于健康探针、错误页及性能优化场景。
在 Nginx 中实现精准匹配，用 = 修饰符即可。它要求请求的 URI 必须与配置中的路径**完全一致**，不能多也不能少，连末尾斜杠、大小写、查询参数（? 后面部分）都不参与匹配，但路径本身必须一字不差。
精准匹配的基本写法
语法很简单：
-
location = /api/login { ... }→ 只匹配GET /api/login，不匹配/api/login/、/api/login?next=/home或/api/login2 -
location = / { ... }→ 只匹配根路径/，这是提升首页响应速度的常用优化 -
location = /healthz { return 200 "OK"; }→ 常用于 Kubernetes 探针，确保路径严格唯一
为什么精准匹配优先级最高
Nginx 匹配 location 时，会先扫描所有 = 规则。一旦命中，立刻执行对应块，不再检查其他任何 location（包括正则、前缀、^~）。这个机制能避免歧义，也保障性能。
- 例如同时存在：
location = /status { ... }location /status { ... }
那么/status请求一定走第一个，第二个永远不会被触发 - 注意：如果写成
location = /status/，那它只匹配带结尾斜杠的/status/，和/status是两个不同路径
常见误区与避坑点
精准匹配看似简单，但容易因细节出错：
-
不处理查询参数：请求
/login?=1仍会匹配location = /login，因为 Nginx 匹配的是 URI 的 path 部分，? 及之后属于 query string，不参与 location 判断 -
大小写敏感：若配置
location = /Admin，则/admin不会匹配，除非改用正则~* -
root 和 alias 行为不同：用
root时，Nginx 会把完整匹配路径拼到根目录后；用alias时，匹配部分会被替换。例如：location = /logo.png { alias /var/www/img/logo.png; }✅location = /logo.png { root /var/www/img; }❌（实际找的是/var/www/img/logo.png/logo.png）
配合 error_page 使用更可靠
精准匹配常与错误页联动，确保特定路径返回明确响应：
-
error_page 404 = /404.html;配合location = /404.html { root /usr/share/nginx/html; }，可避免 404 页面被其他 location 拦截 - 健康检查路径如
/ping推荐用精准匹配 +return，不依赖文件系统，响应更快更稳定
