Nginx | 解决 Spring Boot 与 Nginx 中的 “413 Request Entity Too Large“ 错误
关注:CodingTechWork
引言
在 Web 开发中,413 Request Entity Too Large
是一种常见的 HTTP 错误,它指示客户端请求的实体(例如文件或数据)超出了服务器允许的最大大小。对于使用 Spring Boot 和 Nginx 的应用程序来说,处理和解决这一问题需要理解几个关键技术原理,包括 HTTP 协议、Spring Boot 配置、以及 Nginx 的上传限制。本文将深入探讨这一错误的原因,并提供基于 Spring Boot 和 Nginx 的解决方案。
什么是 413 Request Entity Too Large 错误?
介绍
HTTP 状态码 413 Request Entity Too Large 表示请求的主体部分(如表单数据或文件)超出了服务器允许处理的大小限制。这通常发生在以下场景:
- 客户端上传的文件或数据超过了服务器的最大接收限制。
- 客户端请求的 HTTP 请求体(包括文件和其他数据)超过了服务器的最大限制。
- 在开发文件上传、数据提交等功能时,遇到 413 错误较为常见,尤其是在处理大文件或批量数据时。
413 Request Entity Too Large 产生原因
413 错误通常由以下几种因素导致:
Spring Boot 应用限制
: Spring Boot 默认配置了文件上传和请求体大小的限制。如果上传的文件或数据超过了这个限制,Spring Boot 会返回 413 错误。Nginx 配置限制
: 当 Spring Boot 后端与 Nginx 作为反向代理共同工作时,Nginx 也可能会设置上传体积的最大限制。如果请求体超出了该限制,Nginx 会拒绝该请求并返回 413 错误。代理或负载均衡器
: 如果请求经过了其他代理服务器(如 HAProxy、Cloudflare 等),它们也可能设置了上传大小的限制。
Spring Boot 中的上传限制
Spring Boot 默认对文件上传和请求体的大小进行了限制,通常会通过以下配置项来控制:
配置文件上传大小限制
在 Spring Boot 中,可以通过 application.properties 或 application.yml 来配置文件上传的大小限制:
- 使用 application.properties 配置
# 限制单个文件最大为 10MB
spring.servlet.multipart.max-file-size=10MB # 限制整个请求体最大为 10MB
spring.servlet.multipart.max-request-size=10MB
- 使用 application.yml 配置
spring:servlet:multipart:max-file-size: 10MBmax-request-size: 10MB
这些配置项的含义:
max-file-size
: 限制上传的单个文件大小。max-request-size
: 限制整个 HTTP 请求体的大小(如果上传多个文件,包含所有文件及其他表单数据)。
自定义上传限制
对于更复杂的场景,Spring Boot 允许开发者自定义文件上传的限制。例如,在 application.properties 中可以通过配置:
# 启用文件上传功能
spring.servlet.multipart.enabled=true # 设置临时文件存储目录
spring.servlet.multipart.location=/tmp/uploads
当上传文件时,Spring Boot 会使用 MultipartResolver
来处理文件数据,这些配置会影响文件的上传过程。
Nginx 中的上传限制
当 Spring Boot 应用部署在使用 Nginx 作为反向代理的环境中时,Nginx 会影响请求的处理。如果上传的文件或数据超过了 Nginx 的最大请求体大小,Nginx 会返回 413 Request Entity Too Large 错误。
配置 Nginx 的上传限制
Nginx 使用 client_max_body_size
配置项来限制客户端请求体的大小。默认情况下,Nginx 的限制为 1MB,这对于大多数现代应用来说往往过小。
找到 http、server 或 location 配置块,并在其中添加或修改 client_max_body_size 指令。这个指令定义了客户端可以上传的最大文件大小。例如,要允许上传最大为 100MB 的文件,可以这样设置:
http {client_max_body_size 100M; # 设置最大上传文件为 100MB# 其他配置...
}
或者,如果你只想为特定的站点(server)或路径(location)设置,可以这样配置:
server {listen 80;server_name example.com;client_max_body_size 100M; # 为这个站点设置最大上传文件为 100MB# 其他配置...
}
或者在某个特定路径下设置:
location /upload {client_max_body_size 100M; # 只针对 /upload 路径设置
}
- client_max_body_size: 用于设置 Nginx 接受的最大请求体大小。如果上传的请求体超过这个限制,Nginx 会返回 413 错误。
重新加载 Nginx 配置
修改 Nginx 配置后,需要重新加载配置文件以使改动生效:
sudo nginx -t # 测试配置文件是否正确
sudo systemctl reload nginx # 重新加载 Nginx 配置
Spring Boot 与 Nginx 配合时的常见问题
在 Spring Boot 与 Nginx 配合时,容易遇到以下问题:
请求体大小限制不一致
如果 Nginx 和 Spring Boot 的上传限制设置不一致,可能导致请求在经过 Nginx 时被拒绝,甚至没有传递到 Spring Boot 应用程序。例如,如果 Nginx 的 client_max_body_size 限制为 10MB,而 Spring Boot 设置为 20MB,那么上传请求会在 Nginx 阶段被拦截,Spring Boot 不会收到该请求。
解决方案:确保 Nginx 和 Spring Boot 的配置一致,尤其是在文件上传大小和请求体大小方面。
Nginx 配置的 client_max_body_size 设置过小
Nginx 默认的 client_max_body_size 设置可能过小,导致上传大文件时出现问题。根据实际需求,调整该值。
文件上传过程中的性能问题
在处理大文件上传时,不仅要关注请求体大小,还需要优化文件上传的性能。比如:
- 在 Nginx 和 Spring Boot 中配置适当的缓冲区大小。
- 在 Spring Boot 中使用异步处理文件上传,避免阻塞主线程。
进一步优化和解决方案
使用分片上传(Chunked Uploads)
对于大文件上传,分片上传是解决上传限制的一种常用技术。分片上传将文件分成多个小块逐个上传,每个块的数据量较小,能够绕过服务器的上传大小限制。Spring Boot 可以与前端库(如 Resumable.js 或 Fine Uploader)配合,提供高效的分片上传支持。
使用 Nginx 的代理缓存
对于频繁上传大文件的场景,使用 Nginx 的代理缓存可以提高上传的性能。Nginx 可以缓存文件上传的请求,从而避免每次都从头开始上传。
proxy_cache_path /tmp/nginx_cache levels=1:2 keys_zone=upload_cache:10m max_size=1g;
location /upload/ {proxy_cache upload_cache;proxy_pass http://localhost:8080;
}
设置合理的客户端文件大小验证
在客户端进行文件大小验证,避免上传超大文件,提前在用户端进行筛查,可以有效减轻服务器的负担。
let fileInput = document.getElementById('fileInput');
fileInput.addEventListener('change', function () {let file = fileInput.files[0];// 限制文件大小为 100MBif (file.size > 100 * 1024 * 1024) { alert("文件超过最大允许大小!");// 清空文件输入框fileInput.value = ""; }
});
总结
413 Request Entity Too Large 错误通常由上传大小限制引起,解决这一问题需要从多个方面入手:
调整 Spring Boot 配置
:在application.properties
或application.yml
中设置合适的文件上传和请求体大小。配置 Nginx
:通过client_max_body_size
设置 Nginx 的上传限制,确保与 Spring Boot 配置一致。使用分片上传技术
:对于大文件上传,考虑使用分片上传技术,避免单个请求体过大。优化客户端验证
:在客户端对文件大小进行验证,减少不必要的上传请求。
相关文章:
Nginx | 解决 Spring Boot 与 Nginx 中的 “413 Request Entity Too Large“ 错误
关注:CodingTechWork 引言 在 Web 开发中,413 Request Entity Too Large 是一种常见的 HTTP 错误,它指示客户端请求的实体(例如文件或数据)超出了服务器允许的最大大小。对于使用 Spring Boot 和 Nginx 的应用程序来说…...
CAD批量打印可检索的PDF文件
本文虽介绍CAD使用方法,但还是劝告大家尽早放弃使用CAD软件。。。。太TM难用了 当你打开CAD时发现如下一堆图纸,但是不想一个一个打印时。你可以按照下面操作实现自动识别图框实现批量打印。 1.安装批量打印插件 2.安装后打开CAD,输入命令Bp…...
理解Unity脚本编译过程:程序集
https://docs.unity3d.com/Manual/script-compilation.html 关于Unity C#脚本编译的细节,其中一个比较重要的知识点就是如何自定义Assembly。 预定义的assembly 默认情况下,Unity会按照这个规则进行编译。 PhaseAssembly nameScript files1Assembly-…...
Linux-Ubuntu之SPI串行通信陀螺仪和加速度计
Linux-Ubuntu之SPI串口通信陀螺仪和加速度计 一,SPI通信原理二,ICM-20608六轴传感器控制三,代码1.小tip 一,SPI通信原理 SPI:串行全双工通信,最高能达到百MHZ,通常一个主设备跟多个从设备&…...
【C++/控制台】2048小游戏
源代码: #include <iostream> #include <windows.h> #include <stdio.h> #include <math.h> #include <stdlib.h> #include <conio.h> #include <time.h>// #define KEY_DOWN(VK_NONAME) ((GetAsyncKeyState(VK_NONAME)…...
github gitbook写书
github创建新的仓库 在仓库中添加目录 ‘SUMMARY.md # Summary * [简介](README.md)gitbook 新建一个site https://www.gitbook.com/ 注册账号 取名字 一路 next,注意选免费版 最后 gitbook同步到github 你在主页可以看到 刚刚的test网站 点击右上角圈出来…...
鸿蒙中调整应用内文字大小
1、ui Stack() {Row() {ForEach([1, 2, 3, 4], (item: number) > {Text().width(3).height(20).backgroundColor(Color.Black).margin(item 2 ? { left: 8 } : item 3 ? { left: 7 } : { left: 0 })})}.width(97%).justifyContent(FlexAlign.SpaceBetween).padding({ ri…...
欧拉公式和傅里叶变换
注:英文引文机翻,未校。 中文引文未整理去重,如有异常,请看原文。 Euler’s Formula and Fourier Transform Posted byczxttkl October 7, 2018 Euler’s formula states that e i x cos x i sin x e^{ix} \cos{x} i …...
【C++经典例题】求1+2+3+...+n,要求不能使用乘除法、for、while、if、else、switch、case等关键字及条件判断语句
💓 博客主页:倔强的石头的CSDN主页 📝Gitee主页:倔强的石头的gitee主页 ⏩ 文章专栏: 期待您的关注 题目描述: 原题链接: 求123...n_牛客题霸_牛客网 (nowcoder.com) 解题思路: …...
Robot---奇思妙想轮足机器人
1 背景 传统机器人有足式、轮式、履带式三种移动方式,每种移动方式都有各自的优缺点。轮式机器人依靠车轮在地面上移动,能源利用率高、移动速度快,但是仅以轮子与地面接触,缺乏越障能力和对复杂地形的适应能力,尤其面对…...
升级 Spring Boot 3 配置讲解 —— 如何处理文件上传下载?
学会这款 🔥全新设计的 Java 脚手架 ,从此面试不再怕! 1. 环境准备 在开始之前,确保你已经具备以下环境: JDK 17 或更高版本(Spring Boot 3 要求的最低 JDK 版本)Maven 或 Gradle 构建工具Spr…...
(四)结合代码初步理解帧缓存(Frame Buffer)概念
帧缓存(Framebuffer)是图形渲染管线中的一个非常重要的概念,它用于存储渲染过程中产生的像素数据,并最终输出到显示器上。简单来说,帧缓存就是计算机图形中的“临时画布”,它储存渲染操作生成的图像数据&am…...
WebRTC 在视频联网平台中的应用:开启实时通信新篇章
在当今这个以数字化为显著特征的时代浪潮之下,实时通信已然稳稳扎根于人们生活与工作的方方面面,成为了其中不可或缺的关键一环。回首日常生活,远程办公场景中的视频会议让分散各地的团队成员能够跨越地理距离的鸿沟,齐聚一堂共商…...
Python文件操作
文件的编码 文件编码 思考:计算机只能识别:0和1,那么我们丰富的文本文件是如何被计算机识别,并存储在硬盘中呢? 答案:使用编码技术(密码本)将内容翻译成0和1存入。 编码技术即&am…...
【渗透测试术语总结】
Top 渗透测试常用专业术语 相信大家和我一样,搞不清这些专业名词的区别,所以我来整理一下。 1. POC、EXP、Payload与Shellcode POC:全称 Proof of Concept ,中文 概念验证 ,常指一段漏洞证明的代码。 EXP…...
利用ArcGIS快速准确地统计出地块的现状容积率
研究目的 根据建筑.dwg、建筑.dwg Annotation、建筑.dwg Polygon,地籍边界.shp等数据,利用GIS快速准确地统计出地块的现状容积率。 研究思路 加载数据图层:建筑.dwg Polygon、建筑.dwg Annotation,使用空间连接功能把建筑层数数…...
Linux:守护进程
一、套路 直接来,不铺垫了; #include<iostream> #include<string> #include<cstdlib> #include<unistd.h> #include<unistd.h> #include<sys/types.h> #include<sys/stat.h> #include<funtl.h> const …...
《Spring Framework实战》3:概览
欢迎观看《Spring Framework实战》视频教程 Spring Framework 为基于现代 Java 的企业应用程序提供了全面的编程和配置模型 - 在任何类型的部署平台上。 Spring 的一个关键要素是应用程序级别的基础设施支持:Spring 专注于企业应用程序的 “管道”,以便…...
【云商城】高性能门户网构建
第3章 高性能门户网构建 网站门户就是首页 1.OpenResty 百万并发站点架构 1).OpenResty 特性介绍 2).搭建OpenResty 3).Web站点动静分离方案剖析 2.Lua语法学习 1).Lua基本语法 3.多级缓存架构实战 1).多级缓存架构分析 用户请求网站,最开始…...
IvorySQL 升级指南:从 3.x 到 4.0 的平滑过渡
日前,IvorySQL 4.0 重磅发布,全面支持 PostgreSQL 17,并且增强了对 Oracle 的兼容性。关于 IvorySQL 4.0 的介绍,各位小伙伴可以通过这篇文章回顾:IvorySQL 4.0 发布:全面支持 PostgreSQL 17. 在 IvorySQL…...
GESP202312 四级【小杨的字典】题解(AC)
》》》点我查看「视频」详解》》》 [GESP202312 四级] 小杨的字典 题目描述 在遥远的星球,有两个国家 A 国和 B 国,他们使用着不同的语言:A 语言和 B 语言。小杨是 B 国的翻译官,他的工作是将 A 语言的文章翻译成 B 语言的文章…...
数据库_解决SQL Server数据库log日志过大,清理日志文件方法
SQL Server数据库日志文件过大的原因主要有几个方面: 事务日志记录了所有对数据库进行修改的操作,如插入、更新和删除,这些操作会不断增加日志文件的大小。 长时间运行且未正确结束的事务会持续占用事务日志中的空间,导致日志文…...
Java 的单例模式详解及优化
💖 欢迎来到我的博客! 非常高兴能在这里与您相遇。在这里,您不仅能获得有趣的技术分享,还能感受到轻松愉快的氛围。无论您是编程新手,还是资深开发者,都能在这里找到属于您的知识宝藏,学习和成长…...
关于 webservice 日志中 源IP是node IP的问题,是否能解决换成 真实的客户端IP呢
本篇目录 1. 问题背景2. 部署gitlab 17.52.1 添加repo源2.2 添加repo源 下载17.5.0的charts包2.3 修改values文件2.3.1 hosts修改如下2.3.2 appConfig修改如下2.3.3 gitlab下的sidekiq配置2.3.4 certmanager修改如下2.3.5 nginx-ingress修改如下2.3.6 <可选> prometheus修…...
[python3]xlrd不支持Excel xlsx文件类型
https://xlrd.readthedocs.io/en/latest/ xlrd is a library for reading data and formatting information from Excel files in the historical .xls format. 解决办法:指定支持的版本1.2.0,pip3 install xlrd1.20 pip3 install xlrd1.2.0 Looking …...
React中createRoot函数原理解读——Element对象与Fiber对象、FiberRootNode与HostRootNode
【2024最新版】React18 核心源码分析教程(全61集) Element对象与Fiber对象 在 React 中,Element 对象 和 Fiber 对象 是核心概念,用于实现 React 的高效渲染和更新机制。以下是它们的详细解读: 1. Element 对象 定…...
【网络协议】动态路由协议
前言 本文将概述动态路由协议,定义其概念,并了解其与静态路由的区别。同时将讨论动态路由协议相较于静态路由的优势,学习动态路由协议的不同类别以及无类别(classless)和有类别(classful)的特性…...
DevOps:CI、CD、CB、CT、CD
目录 一、软件开发流程演化快速回顾 (一)瀑布模型 (二)原型模型 (三)螺旋模型 (四)增量模型 (五)敏捷开发 (六)DevOps 二、走…...
网络安全 | WAF防护开通流程与技术原理详解
关注:CodingTechWork 引言 随着互联网安全形势的日益严峻,Web应用防火墙(WAF, Web Application Firewall)逐渐成为网站和应用的标准防护措施。WAF能够有效识别和防止如SQL注入、跨站脚本攻击(XSS)、恶意流…...
【我的 PWN 学习手札】IO_FILE 之 FSOP
FSOP:File Stream Oriented Programming 通过劫持 _IO_list_all 指向伪造的 _IO_FILE_plus,进而调用fake IO_FILE 结构体对象中被伪造的vtable指向的恶意函数。 目录 前言 一、glibc-exit函数浅析 二、FSOP 三、Largebin attack FSOP (…...
Spring——自动装配
假设一个场景: 一个人(Person)有一条狗(Dog)和一只猫(Cat),狗和猫都会叫,狗叫是“汪汪”,猫叫是“喵喵”,同时人还有一个自己的名字。 将上述场景 抽象出三个实体类&…...
C语言——文件IO 【文件IO和标准IO区别,操作文件IO】open,write,read,dup2,access,stat
1.思维导图 2.练习 1:使用C语言编写一个简易的界面,界面如下 1:标准输出流 2:标准错误流 3:文件流 要求:按1的时候,通过printf输出数据,按2的时候,通过p…...
人工智能知识分享第九天-机器学习_集成学习
集成学习 概念 集成学习是机器学习中的一种思想,它通过多个模型的组合形成一个精度更高的模型,参与组合的模型称为弱学习器(基学习器)。训练时,使用训练集依次训练出这些弱学习器,对未知的样本进行预测时…...
腾讯云AI代码助手编程挑战赛-武器大师
作品简介 对话过程能够介绍二战 各种武器 冷战 武器 现代的 各种武器装备,陆海空三军都知道。 技术架构 使用全后端分离的架构,前端使用Vue脚手架,腾讯云修改样式css 开发环境、开发流程 系统:win11 开发工具:VS…...
Python机器学习笔记(十八、交互特征与多项式特征)
添加原始数据的交互特征(interaction feature)和多项式特征(polynomial feature)可以丰富特征表示,特别是对于线性模型。这种特征工程可以用统计建模和许多实际的机器学习应用中。 上一次学习:线性模型对w…...
java_深入理解main方法
深入理解main方法 在 main()方法中,我们可以直接调用 main 方法所在类的静态方法或静态属性。但是,不能直接访问该类中的非静态成员,必须创建该类的一个实例对象后,才能通过这个对象去访问类中的非静态成员,[举例说明]…...
NLP中常见的分词算法(BPE、WordPiece、Unigram、SentencePiece)
文章目录 一、基本概念二、传统分词方法2.1 古典分词方法2.2 拆分为单个字符 三、基于子词的分词方法(Subword Tokenization)3.1 主要思想3.2 主流的 Subword 算法3.3 Subword 与 传统分词方法的比较 四、Byte Pair Encoding (BPE)4.1 主要思想4.2 算法过…...
HTTP/HTTPS ②-Cookie || Session || HTTP报头
这里是Themberfue 上篇文章介绍了HTTP报头的首行信息 本篇我们将更进一步讲解HTTP报头键值对的含义~~~ ❤️❤️❤️❤️ 报头Header ✨再上一篇的学习中,我们了解了HTTP的报头主要是通过键值对的结构存储和表达信息的;我们已经了解了首行的HTTP方法和UR…...
前端 动图方案
1、vue3lottie 解析使用Bodymovin导出为json格式的Adobe After Effects动画 vue3lottie的使用神器:vue3-lottie (electron也适用)-CSDN博客 2、MP4文件 //template部分 <video class"header-bg" src"../../assets/images/screen/layout/heade…...
C#语言的字符串处理
C#语言的字符串处理 引言 在现代编程中,字符串处理是一项重要的技能,几乎在所有编程语言中都有应用。C#语言作为一种强类型的、面向对象的编程语言,提供了丰富的字符串处理功能。这使得开发人员能够方便地进行文本操作,比如字符…...
【shell编程】报错信息:bash: bad file descriptor(包含6种解决方法)
大家好,我是摇光~ 在运行 Shell 脚本时,遇到 bash: bad file descriptor 错误通常意味着脚本尝试对一个无效或不可用的文件描述符(file descriptor)执行了读写操作。 以下是一些可能导致这个问题的原因、详细案例以及相应的解决…...
vscode 配置c/c++环境 中文乱码
D:\MIscrobingDownload\mingw64\binmingw配置到环境变量中 测试一下,按winr输入cmd打开终端 gcc -v g -v安装插件 一 二 run code 因为run code 插件配置实质上是用它提供的指令进行编译执行,因此无法直接使用断点调试功能,需要对配置进行…...
leetcode 面试经典 150 题:两数之和
链接两数之和题序号1题型数组解题方法1. 哈希表,2. 暴力法难度简单熟练度✅✅✅✅✅ 题目 给定一个整数数组 nums 和一个整数目标值 target,请你在该数组中找出 和为目标值 target 的那 两个 整数,并返回它们的数组下标。 你可以假设每种输…...
【Unity报错】error Cs0103: The name ‘keyCode‘ does not exist in the current context
报错提示: 解决方法: KeyCode K大写...
家用万兆网络实践:紧凑型家用服务器静音化改造(二)
大家好,这篇文章我们继续分享家里网络设备的万兆升级和静音改造经验,希望对有类似需求的朋友有所帮助。 写在前面 在上一篇《家用网络升级实践:低成本实现局部万兆(一)》中,我们留下了一些待解决的问题。…...
“AI智能实训系统:让学习更高效、更轻松!
大家好,作为一名资深产品经理,今天我来跟大家聊聊一款备受瞩目的产品——AI智能实训系统。在这个人工智能技术飞速发展的时代,AI智能实训系统应运而生,为广大学习者提供了全新的学习体验。那么,这款产品究竟有哪些亮点…...
【Linux 之一 】Linux常用命令汇总
Linux常用命令 ./catcd 命令chmodclearcphistoryhtoplnmkdirmvpwdrmtailunamewcwhoami 我从2021年4月份开始才开始真正意义上接触Linux,最初学习时是一脸蒙圈,啥也不会,啥也不懂,做了很多乱七八糟,没有条理的笔记。不知…...
Git 从入门到精通
一、环境配置 下载地址:https://git-scm.com/downloads/ 二、用户配置 找到git bash git --version 查看当前版本 git config --global user.name szhipeng625 设置用户名 git config --global user.email szhipeng625gmail.com 设置邮箱 git config --global …...
【Uniapp-Vue3】创建自定义页面模板
大多数情况下我们都使用的是默认模板,但是默认模板是Vue2格式的,如果我们想要定义一个Vue3模板的页面就需要自定义。 一、我们先复制下面的模板代码(可根据自身需要进行修改): <template><view class"…...
Ansible之批量管理服务器
文章目录 背景第一步、安装第二步、配置免密登录2.1 生成密钥2.2 分发公钥2.3 测试无密连接 背景 Ansible是Python强大的服务器批量管理 第一步、安装 首先要拉取epel数据源,执行以下命令 yum -y install epel-release安装完毕如下所示。 使用 yum 命令安装 an…...