正则匹配按配置文件自上而下顺序生效，首个成功匹配即终止后续比对；仅当最长普通前缀匹配不含^~且非=时才触发正则比对；建议用^$锚定、分层隔离及注释避免冲突。
多个正则匹配（~ 或 ~*）同时存在时，**按配置文件中自上而下的书写顺序，第一个成功匹配的 location 生效，其余全部跳过**。
正则匹配只看顺序，不看长度或复杂度
nginx 不会比较正则表达式的“更精确”或“更长”，也不做回溯择优。只要 URI 满足当前正则，就立即采用，不再检查后续任何正则块。
-
location ~ /api/v1/写在前面 → 请求/api/v1/users会命中它，哪怕后面还有location ~ ^/api/v1/users$ -
location ~* \.js$和location ~* \.(js|css|png)$同时存在 → 哪个在前，哪个优先；后者虽覆盖更广，但若排在第二，永远没机会执行 - 区分大小写需留意：
~ /Login不会匹配/login，而~* /login会，但顺序规则不变
正则匹配只在特定条件下触发
正则不是无条件参与竞争。它只会在“最长普通前缀匹配项不含 ^~ 且不是 =”时才进入比对阶段。换句话说：
- 如果请求
/static/main.css，且存在location ^~ /static/，那么所有~和~*都被跳过，根本不会执行 - 如果只有
location /static/（普通前缀）和location ~* \.css$，则先选中/static/作为最长前缀，再进入正则扫描流程，此时顺序才起作用
避免冲突的实用建议
正则冲突本质是逻辑重叠 + 顺序不当。可从三方面入手：
-
收敛范围：用
^锚定开头、$锚定结尾，比如写location ~ ^/healthz$而非location ~ healthz -
分层隔离：把静态资源统一交给
^~处理，API 接口用正则，两者互不干扰 -
显式注释：在正则 location 上加注释说明意图和预期路径，例如
# match legacy /v1/* endpoints, must come before /v2/ rules
