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;
}

扩展练习

Nginx 中 server_name 参数详解 (opens new window)