nginx 导致文件上传中途中断 Failed to load resource: net::ERR_CONNECTION_RESET

封面图 • 2025-10-22 • NGINX

`Failed to load resource: net::ERR_CONNECTION_RESET` 是一个常见的网络错误，表示客户端（如浏览器）在尝试加载资源时，服务器端突然断开了连接。在 Nginx 的上下文中，这通常与文件上传过程中的配置或性能问题有关。

---

## 🔍 常见原因及解决方法

### 1. **Nginx 配置中 `client_max_body_size` 设置过小**
如果你上传的文件大小超过了 Nginx 允许的最大请求体大小，Nginx 会直接关闭连接，导致 `ERR_CONNECTION_RESET`。

#### ✅ 解决方法：
修改 Nginx 配置文件（通常是 `/etc/nginx/nginx.conf` 或 `/etc/nginx/sites-available/your-site`），增加以下内容：

```nginx
http {
    ...
    client_max_body_size 20M;  # 根据需要调整，比如 50M、100M 等
}
```

或者在 server 块中设置：

```nginx
server {
    ...
    client_max_body_size 20M;
}
```

然后重新加载 Nginx：

```bash
sudo nginx -s reload
```

---

### 2. **Nginx 超时设置过短（`proxy_read_timeout`, `proxy_connect_timeout`, `proxy_send_timeout`）**
如果上传时间较长，而 Nginx 的超时设置太短，会导致 Nginx 在等待过程中关闭连接。

#### ✅ 解决方法：
在 Nginx 配置中添加或修改以下参数（通常在 `location /` 或代理块中）：

```nginx
location / {
    proxy_pass http://your_backend;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;

proxy_connect_timeout 300;
    proxy_send_timeout 300;
    proxy_read_timeout 300;
    proxy_buffering off;
}
```

> 如果是直接处理上传（不通过反向代理），也可以考虑使用 `client_body_timeout` 和 `client_header_timeout`：

```nginx
client_body_timeout 300;
client_header_timeout 300;
```

---

### 3. **PHP/FPM 配置限制（如果是 PHP 后端）**
如果你使用的是 PHP 处理上传，PHP 的 `post_max_size` 和 `upload_max_filesize` 也会影响上传行为。

#### ✅ 解决方法：
编辑 `php.ini` 文件，确保以下值足够大：

```ini
post_max_size = 20M
upload_max_filesize = 20M
```

然后重启 PHP-FPM：

```bash
sudo systemctl restart php-fpm
```

---

### 4. **防火墙/安全组/负载均衡器中断连接**
有些云服务提供商（如 AWS、阿里云等）或防火墙规则可能在长时间无响应时主动断开连接。

#### ✅ 解决方法：
- 检查防火墙和安全组规则。
- 如果使用了负载均衡器（如 AWS ELB、Nginx Plus、HAProxy），检查它们的超时设置。
- 调整负载均衡器的超时参数（如 `proxy_read_timeout`、`proxy_connect_timeout`）。

---

### 5. **Nginx 缓冲区设置不当**
如果上传较大文件，Nginx 默认会缓冲整个请求体，这可能导致内存不足或延迟过高。

#### ✅ 解决方法：
在 Nginx 配置中添加以下指令来禁用缓冲（适用于上传场景）：

```nginx
proxy_buffering off;
```

或者：

```nginx
client_body_buffer_size 128k;
client_max_body_size 20M;
```

---

## 🧪 排查步骤建议

1. **查看 Nginx 错误日志**：
   ```bash
   tail -f /var/log/nginx/error.log
   ```

2. **查看 PHP/FPM 日志**（如果适用）：
   ```bash
   tail -f /var/log/php-fpm.log
   ```

3. **使用浏览器开发者工具**（F12）查看具体请求的响应头和状态码。

4. **测试小文件上传是否正常**，以判断是否为文件大小问题。

---

## ✅ 总结：推荐的 Nginx 配置片段（用于大文件上传）

```nginx
http {
    client_max_body_size 20M;
    client_body_buffer_size 128k;
    client_body_timeout 300;
    client_header_timeout 300;

server {
        listen 80;
        server_name example.com;

location /upload {
            client_max_body_size 20M;
            proxy_pass http://backend;
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_connect_timeout 300;
            proxy_send_timeout 300;
            proxy_read_timeout 300;
            proxy_buffering off;
        }
    }
}
```

---

如果你能提供具体的 Nginx 配置或上传方式（如是否通过 FastCGI、代理到 PHP、Node.js 等），我可以给出更精准的建议。欢迎继续提问！