完美解决Nginx上传文件出现“ 413 （499 502 404） Request Entity Too Large”错误的解决方法

最新推荐文章于 2025-07-04 11:07:41 发布

原创最新推荐文章于 2025-07-04 11:07:41 发布 · 6.1k 阅读

35 ·

CC 4.0 BY-SA版权

文章标签：

#nginx #运维

程序bug报错解决方案合集专栏收录该内容

214 篇文章

订阅专栏

在Web开发中，HTTP 413 Request Entity Too Large错误常常出现在客户端发送的请求体超过服务器允许的大小限制时。本文详细解析了这种错误的成因，包括服务器配置、应用层设置及反向代理的限制，并提供了一系列调试和解决方案。本文涵盖了如何在Nginx和Apache服务器中调整配置，修改Spring Boot和Node.js等应用的请求体限制，以及适当配置反向代理和负载均衡器。通过实际示例，读者可以学会如何应对和解决HTTP 413错误，确保系统能够稳定、高效地处理大文件上传和数据请求，从而提升用户体验和系统性能。
在这里插入图片描述

🧑 博主简介：现任阿里巴巴嵌入式技术专家，15年工作经验，深耕嵌入式+人工智能领域，精通嵌入式领域开发、技术管理、简历招聘面试。CSDN优质创作者，提供产品测评、学习辅导、简历面试辅导、毕设辅导、项目开发、C/C++/Java/Python/Linux/AI等方面的服务，如有需要请站内私信或者联系任意文章底部的的VX名片（ID：gylzbk）

💬 博主粉丝群介绍：① 群内初中生、高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

在这里插入图片描述

一、什么是413 Request Entity Too Large错误？

1. 当前HTTP 413错误的定义

HTTP 413错误表示请求体大于服务器允许的最大大小。这个限制可以由服务器配置（如Nginx、Apache等）或应用自身（如Java、Node.js等）来控制。

2. 现象与影响

当HTTP 413错误发生时，客户端通常会收到一条“Request Entity Too Large”的错误信息，表示请求被拒绝并且服务器不会处理该请求。这对于用户体验和系统功能性都会带来负面影响，特别是在文件上传和数据提交这种场景。

二、为什么会产生413错误？

1. 服务器限制

413错误大多数情况下源于服务器的配置限制。服务器通常会设置一个最大请求体大小以保护其自身免受资源消耗过度的攻击。

Nginx：通过 client_max_body_size 指令进行限制。
Apache：通过 LimitRequestBody 指令进行控制。

2. 应用层限制

在某些情况下，应用程序本身也会设置请求体的大小限制。例如，Java的Servlet、Spring Boot以及许多其他框架和库都有自己的大小限制参数。

3. 反向代理/负载均衡设置

在使用反向代理或负载均衡时，也可能设置了请求大小的限制。

三、如何调试和解决413错误？

1. 修改Nginx配置

1.1 修改配置文件

在Nginx中，client_max_body_size指令默认限制为1MB，可以通过配置文件进行调整：

http {
    client_max_body_size 10M;  # 设置为10MB
}

server {
    client_max_body_size 10M;  # 设置为10MB
}

location /upload {
    client_max_body_size 10M;  # 设置为10MB
}

1.2 重载Nginx配置

修改配置文件后，重载Nginx配置使之生效：

sudo nginx -s reload

2. 修改Apache配置

2.1 修改配置文件

在Apache中，可以通过 LimitRequestBody 指令进行控制，设置为10MB：

<Directory "/var/www/html/upload">
    LimitRequestBody 10485760
</Directory>

2.2 重启Apache服务器

修改配置文件后，重启Apache服务器使之生效：

sudo systemctl restart apache2

3. 修改应用配置

3.1 Spring Boot示例

在Spring Boot中，修改application.properties文件，增加如下配置：

spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB

3.2 Node.js（Express）示例

在Node.js的Express框架中，使用body-parser库可以调整请求体大小限制：

const bodyParser = require('body-parser');
const express = require('express');
const app = express();

app.use(bodyParser.json({ limit: '10mb' }));
app.use(bodyParser.urlencoded({ limit: '10mb', extended: true }));

app.post('/upload', (req, res) => {
    res.send('File uploaded successfully');
});

app.listen(3000, () => {
    console.log('Server started on port 3000');
});

4. 配置反向代理/负载均衡器

4.1 例子：Nginx反向代理

如果Nginx作为反向代理服务器，你需要确保在主要服务器配置和反向代理服务器配置中都设置了 client_max_body_size：

# 主服务器配置
http {
    client_max_body_size 10M;  # 设置为10MB
}

# 反向代理配置
server {
    location / {
        proxy_pass http://backend_server;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        client_max_body_size 10M;  # 设置为10MB
    }
}