Nginx常见错误代码总结和分析方法

千家信息网最后更新 2025年12月02日Nginx常见错误代码总结和分析方法403错误

403是很常见的错误代码，一般就是未授权被禁止访问的意思。

可能的原因有两种：
Nginx程序用户无权限访问web目录文件
Nginx需要访问目录，但是autoindex选项被关闭

修复方法：
授予Nginx程序用户权限读取web目录文件
设置autoindex目录为on

location /path/to/website/folder {
...
autoindex on;
... }


413错误

在上传时Nginx返回了413错误："413 Request Entity Too Large"，这一般就是上传文件大小超过Nginx配置引起。

修复方法：
在Nginx.conf增加client_max_body_size的设置，这个值默认是1M，可以增加到8M以提高文件大小限制；
如果运行的是php，那么还要检查php.ini，这个大小client_max_body_size要和php.ini中的如下值的最大值一致或者稍大，这样就不会因为提交数据大小不一致出现的错误。


post_max_size = 8M
upload_max_filesize = 2M


502错误
Nginx 502 Bad Gateway的含义是请求的PHP-CGI已经执行，但是由于某种原因（一般是读取资源的问题）没有执行完毕而导致PHP-CGI进程终止。一般来说Nginx 502 Bad Gateway和php-fpm.conf的设置有关。


修复方法：
1、查看FastCGI进程是否已经启动


ps -aux | grep php-cgi


2、检查系统Fastcgi进程运行情况


除了第一种情况，fastcgi进程数不够用、php执行时间长、或者是php-cgi进程死掉也可能造成Nginx的502错误。


运行以下命令判断是否接近FastCGI进程，如果fastcgi进程数接近配置文件中设置的数值，表明worker进程数设置太少。


netstat -anpo | grep "php-cgi" | wc -l


3、FastCGI执行时间过长


根据实际情况调高以下参数值


fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300;


504错误


Nginx 504 Gateway Time-out的含义是所请求的网关没有请求到，简单来说就是没有请求到可以执行的PHP-CGI。

Nginx 504 Gateway Time-out一般与Nginx.conf的设置有关。

头部太大这种情况可能是由于Nginx默认的fastcgi进程响应的缓冲区太小造成的， 这将导致fastcgi进程被挂起，如果你的fastcgi服务对这个挂起处理的不好，那么最后就极有可能导致504 Gateway Time-out。

默认的fastcgi进程响应的缓冲区是8K，可以调大以下参数：


fastcgi_buffer_size 128k;
fastcgi_buffers 8 128k;
fastcgi_busy_buffers_size 由 128K 改为 256K；
fastcgi_temp_file_write_size 由 128K 改为 256K。


此外，也可能是php-cgi的问题，需要修改php.ini的配置：

将max_children由之前的10改为30，这样操作是为了保证有充足的php-cgi进程可以被使用。
将request_terminate_timeout由之前的0秒改成60秒，这样使php-cgi进程处理脚本的超时时间提高到60秒，可以防止进程被挂起以提高利用效率。