发布时间:2026-09-30 04:30 更新时间:2026-09-30 04:30 阅读量:15
很多站长在 Nginx 里开了 HTTP/2 之后,会遇到一类让人困惑的现象:浏览器明明走的是 h2,后端应用日志里却记录成 HTTP/1.1;或者反过来,前端被降级成了 HTTP/1.1,却一直找不到原因。要理清这类问题,关键是把「一段连接」拆成两段来看:客户端到 Nginx,以及 Nginx 到后端。这两段的协议是各自独立协商的,任何一段的状态都不会自动传递给另一段。
浏览器访问 https://example.com 时,Nginx 在 TLS 握手阶段通过 ALPN 扩展与客户端协商协议。客户端在 ClientHello 的 ALPN 列表里同时给出 h2 和 http/1.1,Nginx 根据自己的 listen ... ssl 配置里是否写了 http2 决定最终选择哪个。如果 Nginx 没开 http2,就会退回 http/1.1,这就是最常见的「协议降级」。
而 Nginx 转发给后端时,走的是 proxy_pass,默认用 HTTP/1.0 或 HTTP/1.1,取决于 proxy_http_version 的设置。也就是说,浏览器到 Nginx 是 h2,不代表 Nginx 到后端也是 h2。Nginx 并不会把前端的 HTTP/2 流原样转发给后端,它会把请求重新封装成自己支持的版本再发出去。所以后端日志里出现 HTTP/1.1 是完全正常的,不必当成故障。
反过来,如果后端是支持 HTTP/2 的服务(比如某些 gRPC 或启用了 h2c 的应用),而 Nginx 用默认的 HTTP/1.0 去连,就会协商失败或降级,表现为 502 或响应异常。这类问题需要显式配置 proxy_http_version 1.1 或使用 grpc_pass 等专用指令,具体以 Nginx 官方文档和实际后端支持为准。
排查协议问题,第一手材料就是日志。Nginx 的 $server_protocol 变量记录的是客户端到 Nginx 这一段的协议,取值通常是 HTTP/1.0、HTTP/1.1 或 HTTP/2。它不会反映 Nginx 到后端的协议。要把它写进访问日志,需要在 log_format 里显式引用:
log_format main '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'proto=$server_protocol upstream=$upstream_addr '
'urt=$upstream_response_time';
access_log /var/log/nginx/access.log main;
加上 proto=$server_protocol 之后,用一条命令就能快速统计协议分布:
awk '{print $NF}' /var/log/nginx/access.log | sort | uniq -c | sort -rn
更稳妥的做法是按字段名匹配,避免日志格式调整后列号错位:
grep -o 'proto=[^ ]*' /var/log/nginx/access.log | sort | uniq -c
如果统计结果里 HTTP/1.1 占了大多数,而你以为站点已经全站 h2,那就要回头检查 listen 配置。注意:HTTP/2 只在 HTTPS 下由浏览器启用,明文 HTTP 走 h2c 的场景浏览器基本不支持,所以 listen 80 上出现 http/1.1 是正常现象。
服务端配置是否正确,可以用 curl 的 -V 看是否带 HTTP2 特性,再用 --http2 强制协商:
curl -V
curl -sI --http2 https://example.com/ | head -n 1
输出第一行如果是 HTTP/2 200,说明 ALPN 协商成功;如果显示 HTTP/1.1 200,则说明服务端没有启用或客户端不支持。想看更细的协商过程,可以用 nghttp 工具(需自行安装):
nghttp -nv https://example.com/ 2>&1 | grep -i alpn
关于连接复用,要分两层理解。前端方向,HTTP/2 天然支持在一条 TLS 连接上并发多个流,浏览器通常只开一到两条连接;后端方向,Nginx 是否复用与 upstream 的 keepalive 配置有关。只有在 upstream 块里写了 keepalive,并在 location 里设置 proxy_http_version 1.1 和 proxy_set_header Connection "",Nginx 才会把到后端的连接放进连接池复用:
upstream backend {
server 127.0.0.1:8080;
keepalive 32;
}
location / {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
这里容易踩的坑是:如果忘了清空 Connection 头,Nginx 会把客户端的 Connection: close 透传给后端,导致后端每次请求后关闭连接,keepalive 连接池形同虚设,表现为后端 TIME_WAIT 增多、响应时间波动。判断是否复用成功,可以在后端侧用 ss -tn state established '( sport = :8080 )' 观察与 Nginx 之间的长连接数量,持续有连接存在说明复用生效。
还有一个常见误区:把 proxy_http_version 设成 2 想启用后端 HTTP/2。Nginx 的 proxy 模块并不支持通过该指令直接开启后端 HTTP/2,写 2 不会达到预期效果,正确方式取决于后端类型,比如 gRPC 用 grpc_pass,具体以官方文档为准。
排查协议混用问题,记住三句话:客户端到 Nginx 的协议看 $server_protocol,Nginx 到后端的协议看 upstream 配置,两者不互相继承。先确认前端 h2 是否真的协商成功,再确认后端连接是否按预期复用,最后用日志字段和抓包交叉验证。如果统计发现大量连接没有复用,优先检查 upstream keepalive 与 Connection 头;如果发现前端被降级,检查 listen 的 http2 参数与证书配置。把这两段分开看,绝大多数「协议错乱」的疑问都能自己理清。
| 📑 | 📅 |
|---|---|
| MySQL 8 表被锁等待排查:从 INNODB_TRX 到阻塞源头 | 2026-09-30 |
| PostgreSQL备库查询被长事务阻塞排查与配置取舍 | 2026-09-29 |
| MySQL慢查询Rows_examined远大于Rows_sent:回表与覆盖索引优化 | 2026-09-29 |
| Docker 容器内 curl 通但宿主不通:端口映射与 iptables 排查 | 2026-09-29 |
| Nginx 长连接被中间设备掐断排查:从抓包 RST 到 keepalive_timeout 调优 | 2026-09-29 |
| Docker容器ulimit不生效排查:句柄继承链路与优先级 | 2026-09-30 |
| PostgreSQL慢查询定位:pg_stat_statements安装与top SQL排序实战 | 2026-09-30 |
| nohup 与 systemd-run 后台任务取舍:SSH 断开进程被杀排查 | 2026-09-30 |
| Nginx 与后端 POST 请求体丢失排查:缓冲与转发链路 | 2026-09-30 |
| MySQL 8 慢查询日志查不到 SQL:digest 归并与真实语句还原 | 2026-09-30 |