必學必會的nginx配置location匹配順序總結

location 匹配規則：

location 路徑正則匹配：

符號	說明
~	正則匹配，區分大小寫
~*	正則匹配，不區分大小寫
^~	普通字符匹配，如果該選項匹配，則，只匹配該選項，不再向下匹配其他選項
=	普通字符匹配，精確匹配
@	定義一個命名的 location，用於內部定向，例如 error_page，try_files

location匹配優先級順序

• 1.精確匹配

    *   `=` 前綴指令匹配，如果匹配成功，則停止其他匹配
  

• 2.普通字符匹配

    * 普通字符串指令匹配，順序是從長到短，匹配成功的location如果使用^~，則停止其他匹配（正則匹配）
  

• 3.正則匹配：

    * 正則表達式指令匹配，按照配置文件裏的順序，成功就停止其他匹配
  

• 4.默認匹配

    * 如果第三步中有匹配成功，則使用該結果，否則使用第二步結果
  

注意點

匹配的順序是先匹配普通字符串，然後再匹配正則表達式。另外普通字符串匹配順序是根據配置中字符長度從長到短，也就是說使用普通字符串配置的location順序是無關緊要的，反正最後nginx會根據配置的長短來進行匹配，但是需要注意的是正則表達式按照配置文件裏的順序測試。找到第一個匹配的正則表達式將停止搜索。

一般情況下，匹配成功了普通字符串location後還會進行正則表達式location匹配。有兩種方法改變這種行爲，其一就是使用=前綴，這時執行的是嚴格匹配，並且匹配成功後立即停止其他匹配，同時處理這個請求；另外一種就是使用^~前綴，如果把這個前綴用於一個常規字符串那麼告訴nginx 如果路徑匹配那麼不測試正則表達式。

• 匹配模式及順序

location = /uri 　　　=開頭表示精確匹配，只有完全匹配上才能生效。
location ^~ /uri 　　^~ 開頭對URL路徑進行前綴匹配，並且在正則之前。
location ~ pattern 　~開頭表示區分大小寫的正則匹配。
location ~* pattern 　~*開頭表示不區分大小寫的正則匹配。
location /uri 　　　　不帶任何修飾符，也表示前綴匹配，但是在正則匹配之後。
location / 　　　　　通用匹配，任何未匹配到其它location的請求都會匹配到，相當於switch中的default。

---

實驗案例

• 測試"^~" 和 “~”，nginx配置如下。瀏覽器輸入http://localhost/helloworld/test，返回601。如將#1註釋，#2打開，瀏覽器輸入http://localhost/helloworld/test，返回603。注：#1和#2不能同時打開，如同時打開，啓動nginx會報nginx: [emerg] duplicate location “/helloworld”…，因爲這兩個都是普通字符串。

location ^~ /helloworld { #1 
	return 601;
} 
#location /helloworld { #2 
# 	return 602;
#}
 location ~ /helloworld { 
 		return 603;
  } 

• 測試普通字符串的長短（普通字符串的匹配與順序無關，與長短有關）。瀏覽器輸入http://localhost/helloworld/test/a.html，返回601。瀏覽器輸入http://localhost/helloworld/a.html，返回602。

location /helloworld/test/ {        #1
    return 601;
}
        
location /helloworld/ {                #2
    return 602;
}

• 測試正則表達式的順序（正則匹配與順序相關）。瀏覽器輸入http://localhost/helloworld/test/a.html，返回602；將#2和#3調換順序，瀏覽器輸入http://localhost/helloworld/test/a.html，返回603

location /helloworld/test/ { #1
return 601;
}

location ~ /helloworld { #2
return 602;
}

location ~ /helloworld/test { #3
return 603;
}