Nginx 中怎么使用 location 前缀匹配实现路由分发-Nginx-PHP中文网

Nginx location前缀匹配按最长字符串前缀优先，=精确匹配最高，^~前缀次之并阻断正则，普通前缀/最长胜出，正则~和~*仅在无更优前缀时按配置顺序执行首个命中者。

nginx 中怎么使用 location 前缀匹配实现路由分发

Nginx 的 location 指令通过前缀匹配（prefix matching）实现静态路径路由分发，核心在于理解匹配顺序和前缀规则——它不依赖正则，而是按最长前缀优先原则选择块。

前缀匹配的基本规则

Nginx 对 location /path/ {...} 这类写法采用“最长字符串前缀匹配”：请求 URI 以该前缀开头即匹配成功，且多个匹配中取最长的那个。注意：不区分大小写（默认），且匹配的是解码后的 URI（如 %20 被转为空格后再比对）。

location /api/ { ... } 匹配 /api、/api/、/api/users、/api/v1/status?x=1
location /api（无尾斜杠）也会匹配 /apixxx —— 因为它是纯前缀，所以要避免这种写法，推荐加尾斜杠或用更明确的限定
location /api/ 和 location /api/users/ 同时存在时，/api/users/list 会命中后者（更长前缀）

常用前缀类型与优先级说明

除了普通前缀，Nginx 还支持带修饰符的前缀匹配，它们有明确的优先级顺序（从高到低）：

= /exact：精确匹配，完全一致才生效（最高优先级）
^~ /prefix：前缀匹配，但一旦匹配成功，**立即停止搜索正则 location**（适合静态资源，提升性能）
/prefix：普通前缀匹配（默认行为，最长前缀胜出）
~ /regex 或 ~* /regex：区分/不区分大小写的正则匹配（最低优先级，仅在前缀都未命中时尝试）

例如：^~ /static/ 比 ~ \.js$ 更早被选中，即使 URI 是 /static/app.js —— 正则根本不会执行。

典型路由分发配置示例

以下是一个常见前后端分离项目的分发逻辑：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

server {
    listen 80;
    server_name example.com;
<pre class="brush:php;toolbar:false;"># 前端单页应用：所有非 API 请求都返回 index.html
location / {
    root /var/www/frontend;
    try_files $uri $uri/ /index.html;
}

# 后端 API 统一代理到 Node.js 服务
location ^~ /api/ {
    proxy_pass http://127.0.0.1:3000/;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
}

# 静态资源强制缓存 & 不走后端
location ^~ /assets/ {
    root /var/www/frontend;
    expires 1y;
    add_header Cache-Control "public, immutable";
}

# 精确匹配 favicon，避免日志刷屏
location = /favicon.ico {
    log_not_found off;
    access_log off;
}

}

这里利用了 ^~ 避免正则干扰，用 = 提升关键小文件效率，/ 默认前缀兜底前端路由。