宝塔面板文件管理器上传大文件失败需同步修改三处：1. 面板config.json中upload_max_size（单位MB，改后执行bt restart）；2. 网站Nginx配置server块内添加client_max_body_size 2048m；3. PHP配置upload_max_filesize和post_max_size均设为2048M并重载PHP。
宝塔面板文件管理器上传大文件失败，不是 PHP 没调大，而是三道关卡全得过：面板自身限制、Nginx 请求体拦截、PHP 层校验。只改其中一项，必然卡在 413 或静默失败。
修改 config.json 中的 upload_max_size
这是宝塔 v7.9.0+ 硬编码的文件管理器上传上限，默认 100MB，和 Nginx、PHP 完全无关，纯属面板前后端通信控制。
- 用 SSH 登录后执行
vim /www/server/panel/data/config.json - 查找
"upload_max_size"字段；若不存在，在 JSON 根对象内新增一行："upload_max_size": 2048,（单位是 MB，注意逗号是否合法） - 保存退出后必须执行
bt restart—— 光刷新页面或重载服务没用 - 该设置只影响「文件管理器」界面上传，不影响网站表单或 API
在 Nginx server 块中添加 client_max_body_size
即使面板允许传 2GB，Nginx 默认只收 1MB 的请求体，超过直接返回 413 Request Entity Too Large，PHP 根本没机会执行。
- 进宝塔 →「网站」→ 点击对应站点 →「配置文件」
- 在
server { }块内、location / { }外部靠前位置添加：client_max_body_size 2048m;（单位小写m，不能写M或MB） - 如果用了反向代理（如通过域名 + SSL 访问面板本身），还要去面板绑定的那个网站配置里同样加这一行
- 务必点击「保存」，再点站点右侧的「重启」按钮——某些版本下只点「重载配置」不生效
同步调整 PHP 的 upload_max_filesize 和 post_max_size
PHP 层有两道检查：upload_max_filesize 控制单个文件上限，post_max_size 控制整个 POST 请求体（含多文件、字段、boundary）总大小。后者必须 ≥ 前者，否则静默截断。
立即学习“PHP免费学习笔记（深入）”；
- 进「软件管理」→ 找到当前网站用的 PHP 版本 →「设置」→「配置修改」
- 确认以下两行都存在且值合理（推荐统一设为
2048M）：upload_max_filesize = 2048M，post_max_size = 2048M - ⚠️ 单位必须是大写
M，2048m或2048MB会被 PHP 忽略 - 检查网站根目录是否存在
.user.ini，如有，删掉里面关于这两个参数的行（它会覆盖 php.ini） - 改完必须点「重载PHP」，不是「保存」就完事——不重载，PHP 进程根本不读新配置
验证与排查常见失败信号
上传失败时别猜，看响应码和日志定位具体哪一关拦住了你：
- 浏览器 Network 面板看到
413 Request Entity Too Large→ Nginx 没生效，回去检查client_max_body_size是否写对位置、是否重启 - 弹窗提示
upload size exceed limit或控制台返回 500 →config.json格式错误或未执行bt restart -
$_FILES为空、$_POST也空，但无 413 → PHP 自己截断了，大概率是post_max_size < upload_max_filesize或.user.ini覆盖了配置 - 上传中途卡住、超时 → 还要调大
max_execution_time和max_input_time（建议 ≥300），并检查upload_tmp_dir是否空间足、权限对
最容易被忽略的是：改完配置不重启服务、单位大小写写错、.user.ini 暗中覆盖、以及反向代理层额外拦截。每一道都得单独验证，不能默认“我改过了就等于生效了”。
