罗罗编程学习记录
本页内容 展开查看

08.5.2 Nginx 配置体系

所属:全栈开发面试题库 / 08 云原生与 DevOps / 08.5 负载均衡与流量接入

覆盖范围

  • Nginx 配置块层级与上下文
  • location 匹配规则与优先级(精确/前缀/正则/通用)
  • upstream 模块与负载均衡策略
  • rewrite 与 return、last/break 语义
  • 变量、日志、错误排查

高频题速览

编号 题目 难度 频率
08.5.2-001 Nginx 的配置块层级是怎样的? 基础 ★★★★★
08.5.2-002 location 匹配的优先级顺序是什么? 基础 ★★★★★
08.5.2-003 =、^~、~、~*、不带修饰符分别是什么含义? 进阶 ★★★★★
08.5.2-004 upstream 支持哪些负载均衡策略? 进阶 ★★★★★
08.5.2-005 rewrite 的 last 与 break 有什么区别? 进阶 ★★★★
08.5.2-006 return 与 rewrite 有什么区别? 进阶 ★★★★
08.5.2-007 Nginx 的变量是怎么工作的? 进阶 ★★★★
08.5.2-008 root 与 alias 的区别是什么? 基础 ★★★★
08.5.2-009 $uri、$request_uri、$document_uri 有什么区别? 进阶 ★★★★
08.5.2-010 如何排查 Nginx 配置不生效? 基础 ★★★★★

08.5.2-001 Nginx 的配置块层级是怎样的?

一句话结论

Nginx 配置从外到内依次为 main(全局)、events(连接事件)、http(HTTP 块)、server(虚拟主机)、location(URL 匹配),内层指令覆盖外层同名指令。

概念解释

  • main:worker 进程数、用户组、错误日志路径、pid 等全局配置。
  • events:连接模型、worker_connections、use epoll 等。
  • http:MIME 类型、日志格式、upstream、gzip、代理相关全局配置。
  • server:监听端口、server_name、SSL 证书、该虚拟主机独有配置。
  • location:URL 匹配规则,决定请求如何被处理。

原理流程

  1. nginx 启动时按层级解析 nginx.conf。
  2. main 与 events 只生效一次。
  3. http 块内可包含多个 server,server 内可包含多个 location。
  4. 每个请求在 server 与 location 上下文中继承配置。

代码 / 示例

worker_processes auto;          # main
events {
    worker_connections 1024;    # events
}
http {
    server {
        listen 80;              # server
        server_name example.com;
        location / {            # location
            root /var/www;
        }
    }
}

常见误区

  • 误区:server 块可以写在 http 外面;正解:server 必须在 http 块内。
  • 误区:location 可以嵌套在 events 里;正解:location 只能在 server 或另一个 location 内。

追问

  • Q:include 指令的作用? A:把其他配置文件 include 进来,通常按 server 或 conf.d 目录拆分,便于维护。
  • Q:配置修改后如何生效? A:nginx -t 检查语法,nginx -s reload 平滑重载,不会中断现有连接。

08.5.2-002 location 匹配的优先级顺序是什么?

一句话结论

Nginx location 匹配顺序为:= 精确匹配命中即停止;^~ 前缀匹配且最长命中则不再查正则;~ 与 ~* 正则按配置顺序匹配,先命中者停止;最后是最长普通前缀匹配。

概念解释

  • =:精确匹配,要求 URI 完全相等,优先级最高。
  • ^~:前缀匹配,如果是最长前缀命中且带 ^~,则不再继续查正则。
  • ~:区分大小写正则匹配。
  • ~*:不区分大小写正则匹配。
  • 无修饰符:普通前缀匹配。
  • @:命名 location,用于内部重定向,不直接匹配外部请求。

原理流程

  1. 先检查所有 = 精确匹配,命中则立即使用。
  2. 再按最长前缀匹配选择候选,若候选带 ^~,直接使用。
  3. 否则按配置文件中的顺序依次检查 ~ 与 ~* 正则,先命中者使用。
  4. 正则都未命中,使用最长普通前缀匹配。

代码 / 示例

location = /favicon.ico { return 204; }          # 1. 精确
location ^~ /static/  { root /var/www; }        # 2. 前缀+^~
location ~* \.(jpg|png)$ { root /var/img; }     # 3. 正则
location /api/   { proxy_pass http://backend; } # 4. 普通前缀
location /       { root /var/www; }

常见误区

  • 误区:正则比前缀匹配优先级高;正解:带 ^~ 的最长前缀会跳过正则,只有普通前缀才会被正则覆盖。
  • 误区:location 按书写顺序匹配;正解:= 与最长前缀是先算出来再选的,正则才按书写顺序。

追问

  • Q:~* 与 ~ 区别? A:~ 区分大小写,~* 不区分大小写。
  • Q:如何验证某个 URI 命中哪个 location? A:在 location 里加 return 200 "matched $uri",或用 error_log /dev/log notice 观察 rewrite 日志。

08.5.2-003 =、^~、~、~*、不带修饰符分别是什么含义?

一句话结论

= 表示精确匹配,^~ 表示前缀匹配且不再查正则,~ 表示区分大小写正则,~* 表示不区分大小写正则,无修饰符表示普通前缀匹配。

概念解释

  • =:严格相等,例如 location = / 只匹配根路径。
  • ^~:前缀匹配命中后立即停止,不进入正则阶段。
  • ~:正则匹配,区分大小写。
  • ~*:正则匹配,不区分大小写。
  • 空:最长前缀匹配,但可能被正则覆盖。

原理流程

  1. Nginx 对 URI 依次做前缀匹配。
  2. 记录最长前缀候选。
  3. 若最长候选带 ^~,直接用它。
  4. 否则按配置顺序跑正则,命中即用。

代码 / 示例

location = /healthz { return 200 "ok"; }
location ^~ /assets/ { root /var/www; }
location ~ \.php$ { fastcgi_pass php; }
location ~* \.(jpg|jpeg|png|gif|css|js)$ { root /var/static; }
location / { proxy_pass http://backend; }

常见误区

  • 误区:^~ 是正则;正解:^~ 是前缀匹配,只是优先级高、跳过正则。
  • 误区:~* 是精确匹配;正解:~* 是不区分大小写的正则匹配。

追问

  • Q:@ 是什么? A:@location 是命名 location,用于内部跳转,如 error_page 404 @fallback。
  • Q:rewrite 后会不会重新走 location 匹配? A:用 last 会重新匹配 location;用 break 只在当前 location 继续执行。

08.5.2-004 upstream 支持哪些负载均衡策略?

一句话结论

Nginx 内置轮询(默认)、加权轮询、ip_hash、least_conn、hash(一致性哈希)、random 六种策略;商业版 Nginx Plus 还支持 least_time、健康检查、主动熔断。

概念解释

  • 轮询(round-robin):默认,依次分发。
  • 加权轮询:按 weight 比例分配。
  • ip_hash:按客户端 IP 哈希,固定后端。
  • least_conn:分给当前最少连接的后端。
  • hash $key:自定义 key,如 hash $request_uri consistent 实现一致性哈希。
  • random:随机选后端,常用于大规模集群。

原理流程

  1. 请求到达 location。
  2. proxy_pass 指向 upstream 名。
  3. upstream 模块按策略选后端。
  4. 失败时按 max_fails/fail_timeout 临时摘除。

代码 / 示例

upstream backend {
    least_conn;
    server 10.0.0.11:80 weight=3 max_fails=3 fail_timeout=10s;
    server 10.0.0.12:80 weight=1 max_fails=3 fail_timeout=10s;
    keepalive 32;
}
upstream cache {
    hash $uri consistent;
    server 10.0.0.21:80;
    server 10.0.0.22:80;
}

常见误区

  • 误区:ip_hash 是最准的会话保持;正解:NAT 出口 IP 相同的用户会被打到同一后端,造成不均。
  • 误区:upstream 里 server 越多越好;正解:健康检查失败的后端会被摘除,过多后端会增加健康检查开销。

追问

  • Q:max_fails 与 fail_timeout 的关系? A:fail_timeout 窗口内累计 max_fails 次失败,后端在该窗口内被认为不可用。
  • Q:backup 与 down 是什么? A:backup 表示备用服务器,只有其他主节点都不可用时才启用;down 表示临时下线。

08.5.2-005 rewrite 的 last 与 break 有什么区别?

一句话结论

rewrite ... last 在改写 URI 后重新从 location 开始匹配;rewrite ... break 停止当前 location 内的 rewrite 阶段,直接在当前 location 继续执行后续指令。

概念解释

  • last:重新发起 location 匹配,可能跳到另一个 location。
  • break:跳出 rewrite 阶段,不再继续匹配其他 location。
  • 两个指令都终止同一条 rewrite 语句的后续规则。

原理流程

  1. 请求进入 location。
  2. rewrite 指令改写 URI。
  3. last:重新走 location 匹配流程。
  4. break:留在当前 location,执行后续 proxy_pass/root 等指令。

代码 / 示例

location /old/ {
    rewrite ^/old/(.*)$ /new/$1 last;
}
location /new/ {
    root /var/www;
}
# /old/foo -> 重写为 /new/foo -> 重新匹配 location /new/
location /static/ {
    rewrite ^/static/(.*)$ /assets/$1 break;
    root /var/www;
}
# /static/foo 直接在当前 location 处理为 /var/www/assets/foo

常见误区

  • 误区:last 会外部 301 跳转;正解:last 是内部 rewrite,不发 30x 响应;要外部跳用 return 301。
  • 误区:break 会停止整个请求处理;正解:break 只停止 rewrite 阶段,后续指令照常执行。

追问

  • Q:rewrite 执行几次? A:rewrite 模块在 server 与 location 阶段都会执行,循环 rewrite 可能造成重写过多(rewrite cycle),Nginx 会在 10 次后报 500。
  • Q:如何避免 rewrite 死循环? A:用 break 或在新 location 里明确处理,避免两个 location 互相 rewrite。

08.5.2-006 return 与 rewrite 有什么区别?

一句话结论

return 直接返回状态码与文本/URL,结束请求处理;rewrite 改写 URI 并继续内部处理,可配合 last/break 重新匹配 location。

概念解释

  • return:立即终止请求,返回指定状态码(200/301/302/404 等)。
  • rewrite:只改 URI,请求仍在内部流转。
  • 301 永久重定向用 return 301;302 临时重定向用 return 302。

原理流程

  1. 匹配到 return 指令。
  2. Nginx 直接构造响应返回客户端。
  3. 不继续后续 rewrite/proxy_pass。

代码 / 示例

location = /healthz {
    return 200 "ok";
}
location /old-path {
    return 301 /new-path;
}

常见误区

  • 误区:rewrite 比 return 更优雅;正解:简单跳转用 return,性能更好且语义清晰。
  • 误区:return 200 后面可以继续 proxy_pass;正解:return 后请求立即结束,后续指令不执行。

追问

  • Q:301 与 302 区别? A:301 永久重定向,浏览器会缓存;302 临时重定向,不缓存。
  • Q:return 301 后 URL 怎么拼? A:return 301 https://new.example.com$request_uri; 把原请求 URI 拼到新域名后。

08.5.2-007 Nginx 的变量是怎么工作的?

一句话结论

Nginx 变量在请求处理过程中按需求值,分预定义变量($uri、$host、$http_xxx)与自定义变量(set $var value);变量只在请求生命周期内有效,不是全局配置。

概念解释

  • 预定义变量:Nginx 内建,如 $request_uri、$remote_addr、$http_user_agent。
  • 自定义变量:用 set 指令赋值,可在 rewrite/map/if 中使用。
  • map 指令:根据一个变量的值派生另一个变量,避免复杂 if。
  • 变量惰性求值:只有被引用时才计算。

原理流程

  1. 请求进入 Nginx。
  2. 预定义变量按请求信息填充。
  3. 配置中的 set/map 派生自定义变量。
  4. 变量在 proxy_set_header、return、rewrite 中被引用。

代码 / 示例

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}
server {
    set $myvar "hello";
    location / {
        return 200 "$myvar $host";
    }
}

常见误区

  • 误区:变量可以在 worker 间共享;正解:变量是请求级别的,不同请求互不影响。
  • 误区:if 里 set 变量可以影响外层;正解:Nginx 的 if 在 rewrite 阶段有著名的"if is evil"坑,复杂逻辑用 map 或 lua。

追问

  • Q:$http_xxx 是什么? A:把请求 Header 名转小写,下划线替换为连字符,如 User-Agent 对应 $http_user_agent。
  • Q:为什么说 if is evil? A:if 在 location 内只在 rewrite 阶段生效,很多指令在 if 里行为不符合预期,应优先用 map、try_files、location 嵌套。

08.5.2-008 root 与 alias 的区别是什么?

一句话结论

root 把 URI 拼到 root 路径后作为文件系统路径;alias 把 location 匹配的前缀替换为 alias 路径后作为文件系统路径。

概念解释

  • root:文件系统路径 = root + URI。
  • alias:文件系统路径 = alias + URI 去掉 location 前缀的部分。

原理流程

  1. 请求 /img/foo.png。
  2. root /var/www:找 /var/www/img/foo.png。
  3. alias /var/img/:location /img/ 命中,找 /var/img/foo.png。

代码 / 示例

location /img/ {
    alias /var/img/;
}
# /img/foo.png -> /var/img/foo.png

location /static/ {
    root /var/www;
}
# /static/foo.png -> /var/www/static/foo.png

常见误区

  • 误区:alias 末尾斜杠无所谓;正解:alias 必须以 / 结尾,否则路径拼接会错。
  • 误区:root 也能重写路径;正解:root 只是把 URI 拼在后面,不能替换前缀;要替换前缀用 alias。

追问

  • Q:location = / 与 root 的配合? A:location = / { root /var/www; index index.html; } 会找 /var/www/index.html。
  • Q:try_files 是什么? A:try_files $uri $uri/ /index.html; 依次检查文件是否存在,都不存在则用最后一个 fallback。

08.5.2-009 $uri、$request_uri、$document_uri 有什么区别?

一句话结论

$uri 是规范化后的当前 URI(已 decode、已改写),$request_uri 是客户端原始请求 URI(含参数),$document_uri 等于 $uri。

概念解释

  • $uri:当前 URI,经过 normalize(decode、去多余斜杠、rewrite 改写后)。
  • $request_uri:原始请求 URI,含 query string,不可被 rewrite 修改。
  • $document_uri:$uri 的别名。

原理流程

  1. 客户端请求 /a%20b?x=1。
  2. $request_uri = /a%20b?x=1(原始)。
  3. $uri = /a b(decode 后)。

代码 / 示例

location / {
    return 200 "uri=$uri request_uri=$request_uri";
}
# 访问 /a%20b?x=1 返回 uri=/a b request_uri=/a%20b?x=1

常见误区

  • 误区:rewrite 会改 $request_uri;正解:rewrite 只改 $uri,$request_uri 保持原始值。
  • 误区:$uri 含 query string;正解:$uri 不含 query,query 在 $args 里。

追问

  • Q:$args 是什么? A:请求的 query string,即 ?x=1&y=2 中的 x=1&y=2。
  • Q:如何在 rewrite 后保留原始参数? A:rewrite ^ /new$is_args$args last;,$is_args 在有参数时为 ?。

08.5.2-010 如何排查 Nginx 配置不生效?

一句话结论

按「语法检查 -> 重载 -> 看日志 -> 确认命中 location」的顺序排查:先 nginx -t 确认语法,再 nginx -s reload,再看 error.log 与 access.log,最后在 location 里加 return 验证命中。

概念解释

  • nginx -t:检查配置语法与文件路径。
  • nginx -T:dump 当前生效配置,确认 reload 后加载的是预期文件。
  • error.log:记录 rewrite、upstream 错误、权限错误。
  • access.log:记录每个请求命中的 location 与响应码。

原理流程

  1. 修改配置后先 nginx -t。
  2. 语法 OK 后 nginx -s reload。
  3. 访问目标 URL,看 access.log 是否记录。
  4. 若未按预期走 location,在各 location 加 return 200 "hit xxx"; 验证。

代码 / 示例

nginx -t
nginx -s reload
nginx -T | grep -A 5 "location /api"
tail -f /var/log/nginx/error.log
tail -f /var/log/nginx/access.log

常见误区

  • 误区:改了配置文件就一定生效;正解:必须 reload,且可能是 include 了其他配置文件覆盖了预期。
  • 误区:浏览器看到的是旧页面就是 Nginx 没 reload;正解:可能是 CDN 或浏览器缓存,先 curl 直接打 Nginx 验证。

追问

  • Q:如何确认 server_name 命中哪个 server? A:用 curl -H "Host: xxx" http://ip/ 测试,或在 server 里加 return 200 "host=$host server_name=$server_name";。
  • Q:404 但文件确实存在? A:检查 root/alias 路径拼接、文件权限、SELinux/AppArmor 是否拒绝 Nginx 读取。

待整理清单

  • [ ] Nginx event 模型与 worker 连接数调优
  • [ ] try_files 与 SPA 前端路由配置
  • [ ] Nginx 与 OpenResty 的 lua 脚本扩展
  • [ ] gzip/brotli 压缩配置