Web 服务器与网关 / 系统课时

正则 Location 为什么容易踩坑

正则 Location 为什么容易踩坑

给图片增加一条正则规则后,API 路径下的同名文件可能突然走错处理器。本篇复现普通前缀被正则覆盖的情况,再用最长前缀上的 ^~ 约束选择范围,明确它的效果和不能覆盖的边界。

学习目标

  • 区分大小写敏感正则与不敏感正则。
  • 识别普通前缀与正则重叠时的实际选择。
  • 用对照请求验证 ^~ 是否符合业务边界。

正则按顺序尝试,不比较长短

Linux 本例中,location ~ 使用大小写敏感正则,location ~* 不区分大小写。正则通常应转义表示字面量的点号,并根据目的限制末尾,例如图片扩展名规则中的 \.png$;漏掉点号转义可能匹配你没有打算覆盖的字符串。

多个正则都能命中时,先写的正则获选,不会自动挑选更长或更具体的模式。普通前缀则先比较长度,之后仍可能被正则覆盖。把规则分散到多个 include 文件时,也要核对展开配置里的真实顺序。

用两个路径观察正则覆盖

片段示例:以下 server 块放入 http 上下文。使用固定文本返回,避免把真实文件不存在造成的 404 混进选择问题。

nginx
server {
    listen 127.0.0.1:8080;
    server_name regex.test;
    location /api/ { return 200 "api-prefix\n"; }
    # ^~ 只影响当前最长匹配前缀之后的正则检查。
    location ^~ /private-api/ { return 200 "guarded-prefix\n"; }
    # 不区分 .png 与 .PNG,两条接口路径都可能满足此正则。
    location ~* \.png$ { return 200 "image-regex\n"; }
    location / { return 404 "outside\n"; }
}

检查并重载后,在同一台机器执行:

bash
# 对照只差前缀修饰符的路径,并验证大小写边界。
for path in '/api/logo.png' '/private-api/logo.png' '/api/LOGO.PNG' '/api/orders'; do
    curl -sS -H 'Host: regex.test' "http://127.0.0.1:8080$path"
done

预期输出:

text
image-regex
guarded-prefix
image-regex
api-prefix

四次均应返回 200。/api/logo.png 先记住普通前缀,随后命中图片正则;/private-api/logo.png 的最长前缀带 ^~,因此跳过同层正则。修改为大小写敏感的 ~ 后,再测大写扩展名,结果会与本例不同。

普通前缀继续检查正则,带保护修饰符的最长前缀直接选定

限制规则变化的影响范围

使用 ^~ /assets/ 会让该路径下原本想由通用正则实现的缓存或访问限制不再自动命中,应把所需配置放到正确的处理规则中,并重新验证。这类修饰符不应被当作无条件的“修复优先级”开关。

本例所有规则平铺在一个站点内,不包含嵌套 location。嵌套前缀与外层正则有额外选择细节,不能只记住“有 ^~ 就永远不会碰到任何正则”这一说法。对复杂结构,先简化成可观测对照配置,再逐步恢复真实处理动作。

发现请求走错规则时,先用固定响应或专用诊断响应头确认选择者,再检查文件和上游。只有在实际处理器已经确定后,502、404 或权限错误的后续排查才有明确方向。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

正则 Location 为什么容易踩坑

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

登录哪都通