多图上传时request()->file()返回null，主因是前端未用name="images[]"且缺少enctype="multipart/form-data"；后端需判空、验规则'images.*'、调大nginx client_max_body_size；保存时应事务包裹并统一处理路径与命名。
多图上传时 request()->file() 返回 null 怎么办
常见原因是前端没用数组格式传文件，比如 <input type="file" name="images"> 只能传单个；多图必须加 []，写成 <input type="file" name="images[]" multiple>。Laravel 的 request()->file('images') 才会返回数组，否则是单个 UploadedFile 或 null。
还要确认表单 enctype 是 "multipart/form-data"，漏了这个，整个 files 都不会进 Laravel 的 request。
- 后端验证别只写
'images' => 'required'，得用'images.*' => 'image|mimes:jpg,jpeg,png|max:2048' -
request()->file('images')在没传图时返回null，不是空数组，要先判空再遍历 - Nginx 有默认
client_max_body_size 1m，多图容易超限，报 413 错误，得调大
Laravel 循环保存多图的正确写法
别在循环里反复调 $request->file('images')[$i]->store()，因为 store() 默认用 public 磁盘，路径重复会覆盖。更关键的是：每调一次 store() 就是一次磁盘写入 + 生成新文件名，但没做任何错误隔离 —— 中间一个失败，前面已存的图就变成“孤儿文件”。
推荐用事务包住整个流程，并统一处理路径和命名：
foreach ($request->file('images') as $file) {
$path = $file->store('uploads/products', ['disk' => 'public']);
ProductImage::create(['product_id' => $product->id, 'path' => $path]);
}
- 确保
ProductImage模型的path字段足够长（如varchar(512)），避免截断 - 如果用
storeAs()自定义文件名，注意扩展名要从$file->extension()拿，别硬写.jpg - 不要在循环里调
$file->move()，它绕过 Laravel 文件系统抽象，没法用云存储驱动
本地开发存图正常，上线后报 “Unable to write to disk”
本质是权限或磁盘配置不一致。Laravel 的 public 磁盘默认指向 storage/app/public，但线上往往用 public/uploads 这类真实路径，而 php artisan storage:link 只在本地生效，部署时没跑这命令，或没给 public/storage 目录写权限。
- 检查
config/filesystems.php里public磁盘的'root'是否指向public_path('uploads')，而不是storage_path('app/public') - 线上运行
chmod -R 755 public/uploads（别用 777） - 如果用 S3，
store()不会报这个错，但会静默失败 —— 要看AWS_ACCESS_KEY_ID环境变量是否加载成功
怎么避免用户重复上传同一张图还占空间
靠文件内容哈希去重，不是靠文件名。Laravel 没内置方案，得自己算 md5_file() 或 sha256_file()，再查库有没有相同哈希值。
但注意：不能在 store() 前算哈希，因为 store() 会移动临时文件，之后再读就可能失败。稳妥做法是先 move() 到临时位置，算完哈希再决定存还是删：
$tempPath = sys_get_temp_dir() . '/' . uniqid() . '.' . $file->extension();
$file->move(dirname($tempPath), basename($tempPath));
$hash = md5_file($tempPath);
if (ProductImage::where('hash', $hash)->exists()) {
unlink($tempPath);
continue;
}
哈希字段记得加数据库索引，不然查得慢。另外，md5_file() 对大图耗内存，生产环境建议限制单图最大 5MB 再进哈希流程。
哈希校验这事，看着简单，但一旦并发上传、临时目录清理不及时、或者中间出错没删临时文件，就会埋坑。真要上，得配好日志和定时清理脚本。
