快捷導(dǎo)航

nginx中的路徑匹配location規(guī)則詳解

更新時(shí)間：2025年04月07日 09:40:12 作者：huangSir-devops

Nginx的匹配規(guī)則用location指令來實(shí)現(xiàn),Nginx 的location指令用于匹配請求的 URI（請求路徑）,并根據(jù)匹配結(jié)果執(zhí)行特定的處理指令,這篇文章主要介紹了nginx中的路徑匹配規(guī)則詳解（location規(guī)則）,需要的朋友可以參考下

Nginx的路徑匹配規(guī)則

Nginx的匹配規(guī)則用location指令來實(shí)現(xiàn)，Nginx 的location指令用于匹配請求的 URI（請求路徑），并根據(jù)匹配結(jié)果執(zhí)行特定的處理指令。location是實(shí)現(xiàn)動靜分離、URL 重寫、反向代理等功能的核心模塊之一.

location匹配規(guī)則分類

location支持多種匹配模式，包括精確匹配、前綴匹配、正則匹配等

精確匹配（=）

優(yōu)先級最高。當(dāng)請求的URI與location后面的字符串完全相同時(shí)，Nginx會選擇這個location塊進(jìn)行處理。(這個好理解，就是路徑完全匹配，一模一樣，優(yōu)先級最高)
示例

location = /favicon.ico {
    # 處理/favicon.ico的請求
}

只有當(dāng)請求URI嚴(yán)格為/favicon.ico時(shí)，上述location塊才會被使用。

最長前綴匹配（^~）

第二優(yōu)先級。請求的URI以某個location后面的字符串開頭，并且這個字符串是最長的（或者使用了^~修飾符），Nginx會選擇這個location塊。但請注意，^~修飾符實(shí)際上會停止后續(xù)的正則匹配搜索。
示例

   location ^~ /hello {
     return  601;
   }
    location ^~ /hellow {
     return  602;
   }
   location ^~ /hello/world {
     return  603;
   }
    location ~ /hello {
     return  604;
   }

對于請求/hello，滿足 601和 604，實(shí)際返回601，就是因?yàn)閊~優(yōu)先級高于正則匹配；
對于請求/hellow，滿足 601和 602，實(shí)際返回602，因?yàn)樽铋L前綴匹配原則；

正則表達(dá)式匹配（~和~*）

第三優(yōu)先級。正則表達(dá)式匹配允許定義更復(fù)雜的URI匹配模式。~表示區(qū)分大小寫的正則匹配，而~*表示不區(qū)分大小寫的正則匹配。
Nginx會按照配置文件中的順序逐個檢查正則表達(dá)式location塊，直到找到第一個匹配的塊。因此，正則表達(dá)式的順序很重要。

示例：

location ~ \.(gif|jpg|png)$ {
    # 處理以.gif、.jpg或.png結(jié)尾的請求（區(qū)分大小寫）
}
location ~* \.(GIF|JPG|PNG)$ {
    # 處理以.GIF、.JPG或.PNG結(jié)尾的請求（不區(qū)分大小寫）
}

對于請求/images/photo.jpg，第一個location塊將被匹配（如果請求是區(qū)分大小寫的）。

普通前綴匹配（無修飾符）

第四優(yōu)先級。普通前綴匹配也按照配置文件中出現(xiàn)的先后順序進(jìn)行匹配，先出現(xiàn)的location指令優(yōu)先匹配。
示例：

   location /hello {
     return  601;
   }
   location /hellow {
     return  602;
   }

對于請求/hellow，滿足 601和 602，實(shí)際返回602，證明滿足長前綴匹配原則

默認(rèn)匹配（/）

優(yōu)先級最低。如果請求的URI與任何特定的location塊都不匹配，Nginx將使用默認(rèn)的location塊（如果有的話）。通常，默認(rèn)的location塊是一個不帶任何修飾符的location /塊。
示例：

location / {
    # 處理所有其他請求
}

總結(jié)

Nginx的location匹配規(guī)則優(yōu)先級可以總結(jié)為：

精確匹配（=）
最長前綴匹配（^~），但會停止后續(xù)的正則匹配搜索
正則表達(dá)式匹配（~和~*），按配置順序
普通前綴匹配（無修飾符），也按配置順序
默認(rèn)匹配（/）

注意事項(xiàng)

正則匹配與順序：正則 location 的匹配順序很重要，因?yàn)?Nginx 會按照配置文件中定義的順序進(jìn)行匹配。
proxy_pass 的路徑替換：在配置 proxy_pass 時(shí)，需要注意 location 后面的 URI 是否包含斜杠（/），這會影響請求的轉(zhuǎn)發(fā)路徑。通常建議 location 和 proxy_pass 要么都加斜杠，要么都不加。
性能優(yōu)化：將精確匹配放在前面，可以減少不必要的正則匹配，提高 Nginx 的處理效率。

到此這篇關(guān)于nginx中的路徑匹配location規(guī)則詳解的文章就介紹到這了,更多相關(guān)nginx 路徑匹配規(guī)則內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: