共计 1357 个字符，预计需要花费 4 分钟才能阅读完成。
问题
一天更新完主分支后启动 nginx, 结果报错：nginx: [emerg] unknown “connection_upgrade” variable
解决方法
网上查，发现是 nginx 配置文件出了问题，将下面 map 代码块补上即可。
http {
map $http_upgrade $connection_upgrade {
default upgrade;
” close;
}
server {
location / {
#…
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}
}
}
思考
虽然问题解决了，但后来我想知道为什么会出现这种情况，以及解决方法的真正原理。在这篇博客可以知道问题出在了 nginx 代理 websocket 上。
什么是 websocket
传统的 http 通讯模式是：客户端发起请求，服务端接收请求并作出响应。
而 websocket 协议复用了 http 的握手通道，具体指的是，客户端通过 HTTP 请求与 WebSocket 服务端协商升级协议。
第一步，建立连接，客户端使用 http 报文的格式发起协议升级的请求，服务端响应协议升级。
第二步，交换数据，客户端与服务端可以使用 websocket 协议进行双向通讯。
nginx 反向代理 websocket
首先，客户端发起协议升级的请求，而 nginx 在拦截时需要识别出这是一个协议升级 (upgrade) 的请求，所以必须显式设置升级（Upgrade head）和连接头(Connection head), 如下：
location /sockjs-node/ {
proxy_pass http://127.0.0.1:4200/sockjs-node/;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}
完成后，nginx 将其作为 WebSocket 连接处理。
接着，服务器响应升级请求，由 nginx 做代理进行处理，这时，需要进行如下配置:
http {
map $http_upgrade $connection_upgrade {
default upgrade;
” close;
}
server {
…
}
}
这时就出现了一开始我所修改的地方，结合上面那段的内容，我大概可以猜出来 map 代码段该作用主要是根据客户端请求中 $http_upgrade 的值，来构造改变 $connection_upgrade 的值，即根据变量 $http_upgrade 的值创建新的变量 $connection_upgrade。由于我没有进行 map 映射，它不知道 connection_upgrade 是什么，所以就会出现 unknown “connection_upgrade” variable 错误。
总结
即使是小小的一点改动，背后也会隐藏庞大的信息。如果止步于解决问题，而不是探索问题，就永远不会有进步。
本人水平有限，欢迎各位在评论区指出不足，你们的反馈就是我的进步动力！参考文档：https://www.nginx.com/blog/we…https://www.cnblogs.com/chyin…