nginx 上传文件 502

### 解决 Nginx 上传文件导致的 502 Bad Gateway 错误

当遇到因上传大文件而引发的 `502 Bad Gateway` 错误时，通常是因为 PHP-FPM 或者 Nginx 的配置未能适配较大的请求体。以下是具体的调整措施：

#### 调整PHP设置
为了允许更大的文件上传量，需修改位于 `/etc/php.ini` 文件中的几个参数[^2]。

upload_max_filesize = 64M
post_max_size = 64M
memory_limit = 128M
max_execution_time = 300

这些指令分别控制单个文件的最大尺寸、POST数据总量以及脚本执行时间和内存占用上限。适当提高数值可以有效减少超限情况的发生。

#### 修改Nginx配置
除了优化PHP端口外，还需确保Nginx本身能够处理较大规模的数据传输。编辑站点对应的虚拟主机配置文件（一般存放在 `/etc/nginx/sites-available/default`），添加或更改以下选项来增强其性能表现[^3]:

client_max_body_size 64m;
fastcgi_buffers 8 16k;
fastcgi_buffer_size 32k;
fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300;

上述命令通过设定客户端提交内容长度限制(`client_max_body_size`) 和 FastCGI 缓冲区大小 (`fastcgi_buffers`, `fastcgi_buffer_size`) 来防止过载；同时也延长了连接建立时间(`fastcgi_connect_timeout`) 及读写操作等待时限(`fastcgi_send_timeout`, `fastcgi_read_timeout`)，从而给予更充裕的时间完成整个过程而不至于中途断开连接造成网关错误。

#### 日志排查
如果按照以上建议进行了相应改动之后仍然存在不稳定现象，则应该进一步查看Nginx的日志记录以便定位具体原因。日志路径通常是 `/var/log/nginx/error.log` 。注意观察是否有类似于 "upstream sent too big header" 这样的提示信息出现，这可能意味着上游服务器返回给Nginx的信息头部过大超过了默认阈值，此时可以通过增加缓冲区容量的方式予以修正。