Laravel后端接收WebUploader分片需用$request->getContent()读取原始二进制流，校验chunk/chunks/fileId参数，按fileId/chunk_{n}存分片；合并前须校验各分片存在性及MD5一致性；断点续传状态应存Redis Set并提供GET /api/upload/chunks/{fileId}接口；nginx需配置client_max_body_size等参数支持大分片。

WebUploader 上传时后端如何接收分片

WebUploader 发送分片时，会把文件切片为多个 blob，每个请求携带固定参数：chunk（当前分片序号，从 0 开始）、chunks（总分片数）、fileId（唯一标识，如 md5 前缀）和 name（原始文件名）。Laravel 后端需用这些参数定位并保存对应分片。

关键点：不要依赖 $_FILES 或 $request->file() 的默认行为——WebUploader 默认用 multipart/form-data 提交，但分片是单个 blob，$request->file('file') 可能为 null，应改用 $request->getContent() 直接读取原始二进制流。

• 检查是否为分片请求：if ($request->has(['chunk', 'chunks', 'fileId']))
• 用 $request->getContent() 获取原始数据，避免 PHP 自动解析失败
• 分片存储路径建议按 fileId/chunk_{n} 组织，例如：storage_path("app/uploads/chunks/{$fileId}/chunk_{$chunk}")
• 务必校验 chunk 和 chunks 是否为合法整数，防止路径遍历或整数溢出

Laravel 合并分片前如何校验完整性

合并不是简单地把所有分片按序 cat 到一起。漏传、重复传、内容损坏都会导致最终文件异常。必须在合并前做两层校验：分片存在性 + 内容一致性。

推荐做法是：每个分片上传成功后，立刻计算其 MD5（或 SHA256），存入缓存（如 Redis）或数据库，键为 "chunk_md5:{$fileId}:{$chunk}"；客户端也应在前端计算每片哈希并随请求带上 chunkMd5 字段。

• 合并前遍历 0 到 $chunks - 1，确认每个分片文件存在且大小非零
• 逐个读取已存分片，重新计算 MD5 并比对缓存值，不一致则中断合并并返回错误
• 可选：对整个拼接后的临时文件再算一次整体 MD5，与客户端传来的 fileMd5 比对（需前端支持）
• 避免在合并过程中长时间锁表或阻塞请求，建议用队列（php artisan queue:work）异步处理

如何用 Laravel 实现断点续传状态查询接口

WebUploader 调用 getUploadedChunks 时，会向后端发起 GET 请求，期望返回已上传成功的分片索引数组（如 [0,1,3,4]）。这个接口必须轻量、无副作用、高并发安全。

不能每次查磁盘是否存在文件——IO 开销大且不一致。最佳实践是：上传分片成功后，立即将该 chunk 索引写入 Redis 的 Set 结构，例如：redis->sAdd("uploaded_chunks:{$fileId}", $chunk)；查询接口直接 smembers 即可。

• 接口路由建议定义为：GET /api/upload/chunks/{fileId}
• 响应格式严格为 JSON 数组：

  [0,1,2,4]

  ，不要包裹在 {"data": [...]} 中，否则 WebUploader 解析失败
• 注意 Redis key 过期策略，可用 EXPIRE 设置 24 小时，避免碎片堆积
• 如果业务要求长期保留上传状态，可降级为查数据库，但必须给 (file_id, chunk) 加联合索引

nginx 配置对大文件分片上传的关键影响

即使 Laravel 逻辑完全正确，nginx 默认配置也会拦截大分片请求——常见报错是 413 Request Entity Too Large 或连接被重置。这不是 PHP 的 upload_max_filesize 能解决的。

必须在 nginx 的 server 或 location 块中显式调大两个参数，并确保它们作用于上传接口路径：

• client_max_body_size 1024m：允许单次请求体最大 1GB（根据业务调整）
• client_body_buffer_size 128k：缓冲区太小会导致频繁写临时文件，影响性能
• 若使用 HTTPS，还需确认 ssl_buffer_size 不过小（默认 4k 通常够用）
• 禁用 client_body_timeout 或设为较大值（如 300s），防止慢速上传被中断

改完记得 nginx -t && nginx -s reload，且要验证生效——可在上传接口里打印 $_SERVER['CONTENT_LENGTH'] 看是否能收到预期大小的请求体。

最常被忽略的是：开发环境用 Valet / Homestead / Sail 时，这些代理层可能自带 nginx 配置，覆盖了你的修改。务必确认最终生效的是你改的那一份。