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 后建议执行以下步骤:

  1. 使用 nginx -t 检查语法。
  2. 使用 reload 平滑加载配置。
  3. 使用代表性 URI 请求验证进入结果。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

掌握 location 匹配

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通