上传失败需同步调整PHP（upload_max_filesize、post_max_size、memory_limit、超时）、Nginx（client_max_body_size、client_body_timeout、proxy_read_timeout）、upload_tmp_dir路径权限、ThinkPHP maxSize（字节值）及分片上传机制，缺一不可。
如果您在PHP项目中尝试上传大型文件但遭遇失败，常见表现为页面空白、返回413错误、$_FILES为空或上传中途中断，则问题极可能源于Nginx与PHP多层配置未同步调整。以下是突破上传大小限制与超时问题的多种方法：
一、同步调大PHP核心上传参数
PHP解析请求前即依据upload_max_filesize和post_max_size进行拦截，二者必须协同生效，缺一不可。仅修改其中一个将导致整个POST请求被静默丢弃。
1、打开实际生效的php.ini文件（通过phpinfo()确认“Loaded Configuration File”路径）。
2、将upload_max_filesize设为期望的单文件上限，例如：upload_max_filesize = 512M。
立即学习“PHP免费学习笔记（深入）”；
3、将post_max_size设为≥该值并预留字段开销，例如：post_max_size = 512M或post_max_size = 520M。
4、同步增大memory_limit至至少1.5倍post_max_size，例如：memory_limit = 1G。
5、设置max_execution_time = 600与max_input_time = 600以覆盖处理阶段耗时。
6、保存后必须重启PHP-FPM服务（如sudo systemctl restart php8.2-fpm），reload无效。
二、解除Nginx请求体与超时拦截
Nginx在请求抵达PHP前即执行校验，client_max_body_size限制整段multipart请求体（含文件+boundary+字段），而client_body_timeout控制慢速上传连接存活时间。未调整这两项，PHP配置再大也无意义。
1、在Nginx对应站点的server块或location ~ \.php$块内添加：
2、client_max_body_size 512M;（数值须≥PHP的post_max_size）。
3、client_body_timeout 600;（单位秒，防止网络抖动中断）。
4、若使用proxy_pass转发至PHP-FPM，还需添加：proxy_read_timeout 600;。
5、执行sudo nginx -t && sudo systemctl reload nginx验证并重载配置。
6、如前端经CDN或负载均衡器，上游代理同样需设置client_max_body_size，否则卡在第一道网关。
三、显式指定并检查PHP临时上传目录
PHP将上传文件暂存至upload_tmp_dir后再交由应用处理。若该目录不存在、不可写、空间不足或位于被清理的/tmp分区，会导致move_uploaded_file()静默失败，且$_FILES['error']仍为0。
1、在php.ini中显式设置可控路径：upload_tmp_dir = /var/www/uploads/tmp。
2、创建该目录：sudo mkdir -p /var/www/uploads/tmp。
3、赋予PHP-FPM运行用户（如www-data或nginx）读写权限：sudo chown www-data:www-data /var/www/uploads/tmp。
4、确保磁盘空间充足：df -h /var/www/uploads。
5、重启PHP-FPM使新路径生效。
四、框架层绕过默认上传校验
ThinkPHP等框架在PHP成功接收后仍会执行二次校验，其maxSize参数默认仅2MB。若未显式覆盖，即使服务器层全放开，框架仍将拒绝大文件。
1、在上传逻辑中显式传入验证规则：$file->validate(['size' => 536870912])（512MB = 536870912字节）。
2、或在config/filesystem.php中全局配置：'maxSize' => 536870912。
3、注意：ThinkPHP的maxSize单位为字节，非字符串如'512M'，填错将导致校验失效。
4、若使用分片上传，需确保每一片的maxSize也按单片大小设置（如5MB分片则设为5242880）。
五、启用分片上传替代硬调参数
单纯扩大限制无法解决网络中断、无进度反馈、内存溢出等问题。分片上传将大文件切分为小块逐个提交，服务端合并，是生产环境唯一可靠方案。
1、前端使用Blob.slice()切片，每片携带file_id、chunk_index、total_chunks元数据。
2、后端接口接收分片时，先校验chunk_index与total_chunks连续性，并将每片暂存为{file_id}_{chunk_index}命名文件。
3、当接收到最后一片时，按序合并所有分片并执行完整校验（如MD5比对）。
4、合并前确保目标存储目录可写、空间充足，且禁用SELinux或调整其上下文策略。
5、合并完成后删除所有临时分片文件，避免磁盘占满。
