0

0

Nginx文件上传大小限制 如何修改client_max_body_size

畫卷琴夢

畫卷琴夢

发布时间:2026-02-28 07:13:11

|

407人浏览过

|

来源于php中文网

原创

client_max_body_size 是 nginx 限制客户端请求体大小的指令,默认值为 1mb,上传超限文件会直接返回 413 错误;需在 http/server/location 块中显式配置,优先级 location > server > http,单位支持 k/m/g(大小写敏感),修改后须 nginx -t 验证并 reload 生效。

nginx文件上传大小限制 如何修改client_max_body_size

client_max_body_size 是什么,为什么上传大文件会失败 Nginx 默认限制请求体大小为 1MB,当用户通过 POSTPUT 上传超过该尺寸的文件时,Nginx 直接返回 413 Request Entity Too Large 错误,根本不会把请求转发给后端应用(比如 Django、Flask、Node.js)。这不是后端代码的问题,也不是浏览器限制,而是 Nginx 在入口就拦截了。

这个值必须显式配置,且只对当前作用域生效——它不继承,也不自动向下传递。

在哪里设置 client_max_body_size 才有效 client_max_body_size 可以出现在三个层级:http、server、location。优先级从高到低是 location > server > http。但实际使用中:
  • 设在 http 块里会影响所有虚拟主机,适合统一策略,但不够灵活
  • 设在 server 块里适用于整个域名,比如只允许某个站点传大文件
  • 设在 location 块里最精准,例如仅对 /upload 路径放宽限制,其他路径保持默认
  • 如果后端是反向代理(如 proxy_pass),必须确保该指令出现在包含 proxy_passlocation 块内,否则无效

常见错误:只改了 http 块,但实际请求匹配的是某个 location,而该 location 没有声明该指令,就会回退到默认值(1MB)。

修改后必须 reload,且注意单位写法 改完配置必须执行 nginx -t 验证语法,再用 nginx -s reload 生效。热重载不重启 worker 进程,但旧连接仍按旧配置处理,新连接才用新规则。
client_max_body_size 100M;

单位支持 kMG(大小写均可),但不能写成 100MB100m(小写 m 会被识别为毫秒,导致解析失败)。数值不能带空格,也不能用科学计数法。

酷维CMS企业网站程序1.0
酷维CMS企业网站程序1.0

后台主要功能如下:1) 系统管理:管理员管理,网站配置,上传文件管理,QQ-MSN 在线客服设置。2) 企业信息:后台自由添加修改企业的各类信息及介绍。3) 产品管理:产品类别新增修改管理,产品添加修改以及产品的审核。4) 调查管理:发布修改新调查。5) 会员管理:查看修改删除会员资料,及锁定解锁功能。可在线给会员发信!6) 新闻管理:能分大类和小类新闻,不再受新闻栏目的限制。7) 留言管理:管理

下载

如果设为 0,表示禁用限制(不推荐生产环境使用)。

还要同步检查后端和中间件的限制 Nginx 放宽只是第一步。很多后端框架或中间件也有自己的上传限制,容易漏掉:
  • PHP:upload_max_filesizepost_max_size(php.ini)
  • Python Flask:request.max_content_length
  • Node.js Express:body-parserlimit 选项,或 multerlimits.fileSize
  • Java Spring Boot:spring.servlet.multipart.max-file-sizemax-request-size
  • Cloudflare 等 CDN:可能自带 100MB 限制,需单独调整

只要其中任意一环没放开,上传仍会失败,而且错误表现可能不同(比如 400、500 或超时),排查时容易误判。

Nginx 的 client_max_body_size 是第一道门,但它不是唯一一道门。改完记得逐层确认,尤其注意 location 块的覆盖关系和单位大小写的细节。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

146

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

84

2026.01.26

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

245

2023.07.27

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

519

2023.08.04

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

587

2023.08.04

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

243

2024.02.23

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

606

2024.07.09

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

3607

2024.08.07

Golang 并发编程模型与工程实践:从语言特性到系统性能
Golang 并发编程模型与工程实践:从语言特性到系统性能

本专题系统讲解 Golang 并发编程模型,从语言级特性出发,深入理解 goroutine、channel 与调度机制。结合工程实践,分析并发设计模式、性能瓶颈与资源控制策略,帮助将并发能力有效转化为稳定、可扩展的系统性能优势。

2

2026.02.27

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
进程与SOCKET
进程与SOCKET

共6课时 | 0.4万人学习

nginx浅谈
nginx浅谈

共15课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号