nginx: [emerg] unknown "connection_upgrade" variable解决与思考

问题

一天更新完主分支后启动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...