在 nginx 中配置不区分大小写的 location 匹配，最直接且推荐的做法是使用正则表达式（`~*`）替代精确或前缀匹配。通过以 `~*` 开头的 location 块，nginx 会在匹配 uri 时忽略字符的大小写差异，从而实现对 `/api/user`、`/api/user` 等路径的统一处理。
如何配置不区分大小写的精确匹配
若需对特定路径进行不区分大小写的精确匹配，应使用 `~* ^/path$` 语法。这种写法强制 Nginx 将请求 URI 与指定模式进行正则比对，并忽略大小写，适用于需要严格限定路径但又不希望区分大小写的场景。
server {
listen 80;
server_name example.com;
# 不区分大小写的精确匹配 /api/data
location ~* ^/api/data$ {
return 200 "Exact match for /api/data";
add_header Content-Type text/plain;
}
# 其他请求默认处理
location / {
root /var/www/html;
index index.html;
}
}
上述配置中，`location ~* ^/api/data$` 会匹配 `/api/data`、`/API/DATA`、`/Api/Data` 等变体，但不会匹配 `/api/data/` 或 `/api/dat`。当请求命中该规则时，Nginx 直接返回 200 状态码及指定文本。若请求未命中任何正则 location，则回退到前缀匹配或默认 location。
如何配置不区分大小写的前缀匹配
若需对所有以某路径开头的请求进行不区分大小写的匹配，可使用 `~* ^/prefix` 语法。这种方式比精确匹配更灵活，适用于静态资源目录或 API 前缀的统一处理，能显著减少重复配置。
server {
listen 80;
server_name example.com;
# 不区分大小写的前缀匹配 /static
location ~* ^/static {
alias /var/www/static_files;
expires 30d;
add_header Cache-Control "public, immutable";
}
# 其他请求默认处理
location / {
root /var/www/html;
index index.html;
}
}
该配置中，`location ~* ^/static` 会匹配 `/static/css/style.css`、`/STATIC/JS/app.js` 等所有以 `/static` 开头（忽略大小写）的 URI。Nginx 会将请求映射到 `/var/www/static_files` 目录下的对应文件。注意，正则匹配的优先级高于普通前缀匹配，因此即使存在 `location /static`，只要正则匹配成功，就会优先执行正则 location 中的指令。若需结合多个条件，可进一步细化正则表达式，例如添加后缀限制 `~* ^/static.*\.jpg$` 仅匹配图片文件。
基于正则匹配优先级和回退机制的具体问题
在 Nginx 中，正则表达式 location 的匹配优先级高于前缀 location，且按配置顺序首次匹配成功即停止搜索。这意味着如果先定义一个宽泛的正则 location，后续更具体的前缀 location 可能永远不会被触发。此外，若正则匹配失败，Nginx 会继续尝试其他 location 块，包括前缀匹配和默认 location，确保请求总能被处理。理解这一机制有助于避免配置冲突和意外行为。
