根本原因是表单缺少enctype=”multipart/form-data”，导致Laravel无法解析文件；多图需用images[]命名、验证加required|array|min:1规则，并统一处理UploadedFile数组。
多图上传时 request()->file() 返回 null 怎么办
根本原因是没在表单里加 enctype="multipart/form-data"，Laravel 不会解析文件字段。哪怕你用 Vue 或 Axios 传 FormData，后端也收不到 file 数据。
- 检查 HTML 表单是否带
enctype="multipart/form-data"，缺了就直接返回空数组 - 如果是 Ajax 提交，确认
FormData正确 append 了多个同名字段，比如form.append('images[]', file)，而不是form.append('images', file) - Laravel 默认只允许单个文件上传，多图必须用数组形式命名字段（如
images[]），否则request()->file('images')只拿到第一个
用 request()->file('images') 拿到的是什么类型
它返回一个 UploadedFile 对象数组（不是普通数组），每个对象都带 store()、getClientOriginalName() 等方法。如果字段名写错或没传文件，就返回 null 或空数组，不会抛异常。
- 务必先判断：
if ($request->hasFile('images') && $request->file('images'))，不能只靠!empty() -
$request->file('images')在多图时是数组；单图时是单个对象 —— 这个行为不一致，容易在循环里报错 - 推荐统一转成数组：
is_array($files) ? $files : [$files]，避免后续逻辑分支
storeAs() 循环保存时文件名重复怎么办
直接用 $file->getClientOriginalName() 当文件名，用户上传同名图就会覆盖。Laravel 不自动重命名，得自己处理。
- 别用原始名存盘，改用
$file->storeAs('uploads/images', Str::uuid() . '.' . $file->extension(), 'public') - 如果需要保留原名语义，可用
Str::slug(pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME))+ 时间戳拼接 - 注意
storeAs()的第三个参数是 disk 名（如'public'），不是路径；路径写在第二个参数里 - 批量保存时别共用同一个
Storage::disk('public')实例做多次 write，没性能问题，但要注意 catchFileNotFoundException等磁盘异常
验证多图字段的规则怎么写才不漏掉
'images.*' => 'required|image|mimes:jpg,jpeg,png,gif|max:2048' 是常见写法，但它只校验“每个文件”，不校验“有没有传”。真正漏掉的是整体数量控制和空数组陷阱。
- 加一条顶层规则：
'images' => 'required|array|min:1|max:10'，防止用户选了文件又取消导致空数组 -
required|array必须写，否则images.*规则在images字段根本不存在时会被跳过 -
前端限制选图数量（如
input[multiple][max=10]）只是体验优化，后端验证不可省 - 验证失败后，
$errors里images.0是第一个文件错误，images是整体错误 —— 渲染提示时别只读images.*
事情说清了就结束。最常被绕开的是表单 enctype 和验证层的 images 整体规则，这两处一漏，后面所有逻辑都可能静默失效。
