Nginx常见报错及解决方案

本文汇总使用 nginx 过程中常见报错及解决方案。

2.1 permission denied

问题描述：

集群环境，有线网络正常，无线网络登录页面空白，但是节点可以正常登录。

日志文件如下图所示：

原因分析：

nginx 无权限读取数据流。

解决方案：

修改 nginx.conf ，将用户组改成 root ，并且取消注释。如下图所示：

2.2 https protocol requires SSL

问题描述：

启动时报错：

nginx:[emerg]https protocol requires SSL support in /usr/nginx/conf/nginx.conf:39

原因分析：

nginx.conf 中配置了 https ，但 nginx 未配置 ssl 模块。

解决方案：

给 nginx 增加 ssl 模块，请参见 配置 SSL 证书实现 HTTPS 访问

2.3 nginx 编译缺乏依赖

问题描述：

报错：SSL modules require the OpenSSL library

如下图所示：

原因分析：

nginx 在编译一些模块时，需要三个依赖库：prce、zlib、openssl

解决方案：

yum -y install gcc pcre pcre-devel zlib zlib-devel openssl openssl-devel

2.4 nginx 入口访问平台空白

问题描述：

nginx 入口访问平台空白，日志显示写缓存文件失败，如下图所示：

解决方案：

如果启动 nginx 的用户有对应目录读写权限，则可能是磁盘空间不足引起，可用df -h指令查看。

nginx.conf 中关闭 acces.log ，避免日志过大，把磁盘空间占完。

2.5 集群环境/服务器经常出现卡慢

问题描述：

集群环境，服务器经常出现卡慢。

解决方案：

由于磁盘空间不足，nginx.conf 中关闭 acces.log ，避免日志过大，把磁盘空间占完。

2.6 nginx 配置外网后端口丢失

问题描述：

用户做了 Web 集群，现在做了外网映射，访问 URL 能登录到登录页面，但是点击登录之后，映射的端口号不见了，跳转之后就直接报 404 。

原因分析：

登录跳转后，host 变动，导致端口丢失。

解决方案：

nginx 修改 head 的 host 字段（proxy_set_header Host）为实际外部访问的地址，如下图所示：

2.7 nginx 分块请求异常

问题描述：

Linux 服务器集群，刷新 frm 模板，会出现部分模块加载不出的情况，每次加载不出的模块都是随机的。Dec.socket.connected返回 true ，但是前端有关于 38888 和 38889 的报错。

原因分析：

用户 nginx.conf 默认是用的是http1.0，tcp 连接生命周期不够，导致一些耗时较长的图表请求超时。

解决方案：

nginx 配置 http1.1 和 connection 头置空，响应分块请求。如下图所示：

2.8 nginx 配置无法访问 css 和 js 等静态资源

问题描述：

访问类似localhost:8080\WebReport\ReportServer，页面空白，控制台报错：Failed to load resource:the server responded with a status of 404(not Found)

原因分析：

nginx入口：http://localhost/reportService/WebReport/decision

Tomcat：http://ip:port/WebReport/decision

用户在 nginx 在匹配/reportService转发给后端 Tomcat 处理，而后端返回资源请求时不带/reportService，导致重定向到了 nginx 静态资源路径，访问报错。

nginx配置：

解决方案：

方案一：nginx 层面

拦截/WebReport/decision，重定向为/reportService/WebReport/decision

需要注意以下两点：

• rewrite 是 301 重定向，return 是 307 重定向。

• server_name 为 localhost 时，通过 127.0.0.1 访问，重定向后会有跨域报错，ajax error。

方案二：Tomcat 层面

设置虚拟目录，使得 tomcat url 变为：http://ip:port/reportService/WebReport/decision

具体步骤

（1）将工程移出webapp，避免重复加载；

（2）修改tomcat conf/server.xml，docbase为工程绝对路径

（3）修改nginx.conf，去掉斜杠

注：带斜杠时，是将/reportService/后面的请求转发给后面。

2.9 模板挂载到决策平台不显示

问题描述：

模板直接在设计器预览是正常的；挂载到集群地址，模板空白；挂载到集群节点，模板正常展示。

原因分析：

外网有一个转发工具，转发到了设置在内网的 nginx ，然后通过代理到后台节点，内网访问也会经过 nginx 转发，但是由于转发工具的端口与 nginx 端口不一致，并且没有把外网地址的 port 正确传入，导致最后拿到的是 nginx 端口号，但是内网是直接经过 nginx 了，所以可以正常展示端口号

解决方案：

nginx 配置的端口监听直接改成与外网端口号一致，这样就避免了此类 port 不一致的情况。