文档被挂起

上海纽斯达科技

Nginx常见错误与解决方法

上海纽斯达科技有限公司

2014-10-25

文档状态

目的：

在Nginx服务器出现故障时，能快速定位并解决相关错误。

保密：

本文档仅供内部使用，请勿外传

概述：

Nginx常见错误与问题之解决方法技术指南。

安装环境：

系统环境：redhatenterpri6.564bit

文件状态：

【】草稿

【】修改稿

【√】正式发布

文档编号Nsdkj-778保密等级限制

作者刘恒亮最后完成日期2014-12-25

审核人最后审核日期2014-12-25

批准人最后批准日期2014-12-25

1、Nginx常见启动错误

有的时候初次安装nginx的时候会报这样的错误

sbin/nginx-cconf/

报错内容：sbin/nginx:errorwhileloadingsharedlibraries:.1:

cannotopensharedobjectfile:Nosuchfileordirectory

启动时如果报异常errorwhileloadingsharedlibraries:.1:cannotopen

sharedobjectfile:Nosuchfileordirectory这说明我们的环境还不是和启动需要

小小的配置一下

解决方法(直接运行)：

32位系统[root@verlib]#ln-s/usr/local/lib/.1/lib

64位系统[root@verlib]#ln-s/usr/local/lib/.1/lib64

然后执行ps-ef|grepnginx查看nginx进程确认是否真的已经启动了，在进程列表里会

有最起码两个，worker(nginx工作进程)和master（nginx主进程）

root43491002:24?00:00:00nginx:masterprocesssbin/nginx-c

conf/

nginx43504349002:24?00:00:00nginx:workerprocess

root435628335002:30pts/100:00:00grepnginx

NGINX就OK了

2、400badrequest错误的原因和解决办法

配置相关设置如下.

client_header_buffer_size16k;

large_client_header_buffers464k;

根据具体情况调整，一般适当调整值就可以。

3、Nginx502BadGateway错误

在和中分别有这样两个配置项：max_execution_time和

request_terminate_timeout。

这两项都是用来配置一个PHP脚本的最大执行时间的。当超过这个时间时，PHP-FPM不只会终止

脚本的执行，

还会终止执行脚本的Worker进程。所以Nginx会发现与自己通信的连接断掉了，就会返回给客

户端502错误。

以PHP-FPM的request_terminate_timeout=30秒时为例，报502BadGateway错误的具体信息

如下：

1）Nginx错误访问日志：

2013/09/1901:09:00[error]27600#0:*78887recv()failed(104:Connection

retbypeer)whilereadingresponheaderfromupstream,

client:192.168.1.101,rver:,request:"POST/

HTTP/1.1",upstream:"fastcgi://unix:/dev/shm/:",

host:"",referrer:"/"

2）PHP-FPM报错日志：

WARNING:child25708exitedonsignal15(SIGTERM)after21008.883410

condsfromstart

所以只需将这两项的值调大一些就可以让PHP脚本不会因为执行时间长而被终止了。

request_terminate_timeout可以覆盖max_execution_time，

所以如果不想改全局的，那只改PHP-FPM的配置就可以了。

此外要注意的是Nginx的upstream模块中的max_fail和fail_timeout两项。有时Nginx与上

游服务器（如To口若悬什么 mcat、FastCGI）的通信只是偶然断掉了，

但max_fail如果关爱残疾人手抄报 设置的比较小的话，那么在接下来的fail_timeout时间内，Nginx都会认为上

游服务器挂掉了，都会返回502错误。

所以可以将max_fail调大一些，将fail_timeout调小一些。

4、Nginx出现的413RequestEntityTooLarge错误

这个错误一般在上传文件的时候会出现，

编辑Nginx主配置文件，找到http{}段，添加

client_max_body_size10m;//设置多大根据自己的需求作调整.

如果运行php的话这个大小client_max_body_size要和中的如下值的最大值一致或

者稍大，这样就不会因为提交数据大小不一致出现的错误。

post_max_size=10M

upload_max_filesize=2M

5、解决504GatewayTime-out(nginx)

遇到这个问题是在升级discuz论坛的时候遇到的一般看来,这种情况可能是由于nginx默认的

fastcgi进程响应的缓冲区太小造成的,这将导致fastcgi进程被挂起,如果你的fastcgi服务

对这个挂起处理的不好,那么最后就极有可能导致504GatewayTime-out,现在的网站,尤其某

些论坛有大量的回复和很多内容的,一个页面甚至有几百K。默认的fastcgi进程响应的缓冲区

是8K,我们可以设置大点在里,加入：fastcgi_buffers8128k这表示设置

fastcgi缓冲区为8128

当然如果您在进行某一项即时的操作,可能需要nginx的超时参数调大点，例如设置成90秒：

nd_timeout90;只是调整了这两个参数,结果就是没有再显示那个超时,效果不错

Nginx中关于与上游服务器通信超时时间的配置factcgi_connect/read/nd_timeout。

以Nginx超时时间为90秒，PHP-FPM超时时间为300秒为例，报504GatewayTimeout错误时

的Nginx错误访问日志如下：

2013/09/1900:55:51[error]27600#0:*78877upstreamtimedout(110:

Connectiontimedout)whilereadingresponheaderfromupstream,

client:192.168.1.101,rver:,request:"POST/

HTTP/1.1",upstream:"fastcgi://unix:/dev/shm/:",

host:"",referrer:"/"

调高这三项的值（主要是read和nd两项，默认不配置的话Nginx会将超时时间设为60秒）

之后，504错误也解决了。

而且这三项配置可以配置在http、rver级别，也可以配置在location级别。担心影响其他应

用的话，就配置在自己应用的location中吧。

要注意的是factcgi_connect/read/nd_timeout是对FastCGI生效的，而

proxy_connect/read/nd_timeout是对proxy_pass生效的。

配置举例：

location~.php${

root/home/cda

i/;

includefastcgi_para

ms;

fastcgi_connect_timeout180;

fastcgi_read_timeout600;

fastcgi_nd_timeout600;

fastcgi_passunix:/dev/shm/php

-;

fastcgi_;

fastcgi_paramSCRIPT_FILENAME

/home/cdai/$fastcgi_script_name;

}

6、如何使用NginxProxy

朋友一台服务器运行tomcat为8080端口,IP:192.168.1.2:8080,另一台机器

IP:192.168.1.8.朋友想通过访问192.168.1.8即可访问tomcat服务.配置如下:

在192.168.1.8的上配置如下:

rver{

listen80;

rver_

location/{

proxy_pass192.168.1.2:8080;

include/usr/local/nginx/conf/;

}

}

7.安装完成Nginx后无法站外访问？

刚安装好nginx一个常见的问题是无法站外访问，本机wget、telnet都正常。而服务器之外，

不管是局域网的其它主机还是互联网的主机都无法访问站点。如果用telnet的话，提示：

正在连接到...不能打开到主机的连接，在端口80:连接失败

如果用wget命令的话，提示：

Connectingto192.168.0.1证婚人讲话稿 failed:Noroutetohost.

如果是以上的故障现象，很可能是被CentOS的防火墙把80端口拦住了，尝试执行以下命令，打

开80端口：

iptables-IINPUT-ptcp--dport80-jACCEPT

然后用：

/etc/init.d/iptablesstatus

查看当前的防火墙规则，如果发现有这样一条：

ACCEPTtcp--0.0.0.0/00.0.0.0/0tcpdpt:

80

就说明防火墙规则已经添加成功了，再在站外访问就正常了。

8、如何关闭Nginx的LOG

access_log/dev/null

error_log/dev/null

此外，错误日志主要记录客户端访问nginx出错时的日志，通过错误日志，能快速定位客户端访

问异常！

错误信息错误说明

"upstreamprematurely（过早

的）clodconnection"

请求uri的时候出现的异常，是由于

upstream还未返回应答给用户时用户断

掉连接造成的，对系统没有影响，可以

忽略

"recv()failed(104:Connectionret

bypeer)"

（1）服务器的并发连接数超过了其承载

量，服务器会将其中一些连接Down掉；

（2）客户关掉了浏览器，而服务器还在

给客户端发送数据；

（3）浏览器端按了Stop

"(111:Connectionrefud)while

connectingtoupstream"

用户在连接时，若遇到后端upstream挂

掉或者不通，会收到该错误

"(111:Connectionrefud)while

readingresponheaderfrom

upstream"

用户在连接成功后读取数据时，若遇到

后端upstream挂掉或者不通，会收到该

错误

"(111:Connectionrefud)while

ndingrequesttoupstream"

Nginx和upstream连接成功后发送数据

时，若遇到后端upstream挂掉或者不通，

会收到该错误

"(110:Connectiontimedout)while

connectingtoupstream"

nginx连接后面的upstream时超时

"(110:Connectiontimedout)whi小人书收藏 le

nginx读取来自upstream的响应时超时

readingupstream"

"(110:Connectiontime坐月子怎么吃 dout)while

readingresponheaderfrom

upstream"

nginx读取来自upstream的响应头时超

时

"(110:Connectiontimedout)while

readingupstream"

nginx读取来自upstream的响应时超时

"(104:Connectionretbypeer)while

connectingtoupstream"

upstream发送了RST，将连接重置

"upstreamntinvalidheaderwhile

readingresponheaderfrom

upstream"

upstream发送的响游戏法 应头无效

"upstreamntnovalidHTTP/1.0

headerwhilereadingresponheader

fromupstream"

upstream发送的响应头无效

"clientintendedtondtoolarge

body"

用于设置允许接受的客户端请求内容的

最大值，默认值是1M，client发送的body

超过了设置值

"reopeninglogs"

用户发送kill-USR1命令

"gracefullyshuttingdown",

用户发送kill-WINCH命令

"norversareinsideupstream"nba名人堂成员名单

upstream下未配置rver

"noliveupstreamswhileconnectingto

upstream"

upstream下的rver全都挂了

"SSL_do_handshake()failed"

SSL握手失败

"ngx_slab_alloc()failed:nomemoryin

SSLssionsharedcache"

ssl_ssion_cache大小不够等原因造成

"couldnotaddnewSSLssiontothe

ssioncachewhileSSLhandshaking"

ssl_ssion_cache大小不够等原因造成