Nginx常见错误与解决方法

目的：

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

保密：

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

概述：

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

安装环境：

系统环境：redhat enterprise6.564bit

1、Nginx常见启动错误

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

sbin/nginx-c conf/nginx.conf

报错内容：sbin/nginx:error while loading shared libraries:libpcre.so.1:

cannot open shared object file:No such file or directory

启动时如果报异常error while loading shared libraries:libpcre.so.1:cannot open shared object file:No such file or directory这说明我们的环境还不是和启动需要

小小的配置一下

解决方法(直接运行)：

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

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

然后执行ps-ef|grep nginx查看nginx进程确认是否真的已经启动了，在进程列表里会有最起码两个，worker(nginx工作进程)和master（nginx主进程）

root43491002:24?00:00:00nginx:master process sbin/nginx-c

conf/nginx.conf

nginx43504349002:24?00:00:00nginx:worker process

root435628335002:30pts/100:00:00grep nginx

NGINX就OK了

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

配置nginx.conf相关设置如下.

client_header_buffer_size16k;

large_client_header_buffers464k;

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

3、Nginx502Bad Gateway错误

在php.ini和php-fpm.conf中分别有这样两个配置项：max_execution_time和

request_terminate_timeout。

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

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

以PHP-FPM的request_terminate_timeout=30秒时为例，报502Bad Gateway错误的具体信息如下：

1）Nginx错误访问日志：

2013/09/1901:09:00[error]27600#0:*78887recv()failed(104:Connection reset by peer)while reading response header from upstream,

client:192.168.1.101,server:,request:"POST/index.php

HTTP/1.1",upstream:"fastcgi://unix:/dev/shm/php-fcgi.sock:",

host:"",referrer:"/index.php"

2）PHP-FPM报错日志：

WARNING:child25708exited on signal15(SIGTERM)after21008.883410 seconds from start

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

request_terminate_timeout可以覆盖max_execution_time，

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

此外要注意的是Nginx的upstream模块中的max_fail和fail_timeout两项。有时Nginx与上游服务器（如Tomcat、FastCGI）的通信只是偶然断掉了，

但max_fail如果设置的比较小的话，那么在接下来的fail_timeout时间内，Nginx都会认为上游服务器挂掉了，都会返回502错误。

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

4、Nginx出现的413Request Entity Too Large错误

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

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

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

如果运行php的话这个大小client_max_body_size要和php.ini中的如下值的最大值一致或者稍大，这样就不会因为提交数据大小不一致出现的错误。

post_max_size=10M

upload_max_filesize=2M

5、解决504Gateway Time-out(nginx)

遇到这个问题是在升级discuz论坛的时候遇到的一般看来,这种情况可能是由于nginx默认的fastcgi进程响应的缓冲区太小造成的,这将导致fastcgi进程被挂起,如果你的fastcgi服务对这个挂起处理的不好,那么最后就极有可能导致504Gateway Time-out,现在的网站,尤其某些论坛有大量的回复和很多内容的,一个页面甚至有几百K。默认的fastcgi进程响应的缓冲区是8K,我们可以设置大点在nginx.conf里,加入：fastcgi_buffers8128k这表示设置fastcgi缓冲区为8×128

当然如果您在进行某一项即时的操作,可能需要nginx的超时参数调大点，例如设置成90秒：send_timeout90;只是调整了这两个参数,结果就是没有再显示那个超时,效果不错

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

以Nginx超时时间为90秒，PHP-FPM超时时间为300秒为例，报504Gateway Timeout错误时的Nginx错误访问日志如下：

2013/09/1900:55:51[error]27600#0:*78877upstream timed out(110: Connection timed out)while reading response header from upstream,

client:192.168.1.101,server:,request:"POST/index.php

HTTP/1.1",upstream:"fastcgi://unix:/dev/shm/php-fcgi.sock:",

host:"",referrer:"/index.php"

调高这三项的值（主要是read和send两项，默认不配置的话Nginx会将超时时间设为60秒）之后，504错误也解决了。

而且这三项配置可以配置在http、server级别，也可以配置在location级别。担心影响其他应用的话，就配置在自己应用的location中吧。

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

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

配置举例：

location~\.php${