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://segmentfault.com/a/1190000018712908

NGINX as a WebSocket Proxy

https://www.cnblogs.com/chyingp/p/websocket-deep-in.html