NGINX报错413 Request Entity Too Large的问题解决

1、概述

最近做的项目涉及到文件的上传，而且是批量上传，在实际上传时接口出现了”413 Request Entity Too Large” 这个错误。今天就记录下这个错误的解决过程。

2、结果过程

当在使用 NGINX 时遇到 “413 Request Entity Too Large” 错误时，这意味着客户端发送的请求体超过了 NGINX 服务器所允许的最大限制。这个问题通常出现在上传或提交大型文件时。通常可以通过修改Nginx配置文件中的client_max_body_size来解决。

在配置文件中的http块、server块、location块中都可以配置该属性，区别在于它们的作用于不同。

2.1、在http块中配置

在 NGINX 的 http 块中进行配置时，将会在全局生效。具体操作为，可以在 NGINX 配置文件的 http 块中添加以下指令，以设置全局请求体大小限制：

http { # 这将适用于所有服务器块(server)中的请求。 client_max_body_size 20M; }

2.2、在server块中配置

在特定的服务器块中设置，这将只在相应的server中生效。

如果有多个服务器块（例如虚拟主机），可以在每个服务器块中设置请求体大小限制。在相关的 server 块中添加以下指令：server { # 这将仅对该服务器块中的请求生效。 client_max_body_size 20M; }

2.3、在location块中配置

在 NGINX 的 location块中设置，这将只在相应location块中生效。如果希望仅针对特定的 URL 路径设置请求体大小限制，你可以在相应的 location 块中添加以下指令：

location /upload { # 这将仅对匹配 `/upload` 路径的请求生效 client_max_body_size 20M; }

3、总结

需要牢记的是，在进行任何修改之后，都需要重新加载或重启 NGINX 服务器以使更改生效。友提：确保在修改文件之前备份配置文件，以防止意外的配置错误。根据具体场景和需求，选择适合的位置进行修改，并确保所有相关配置文件都被更新。