在 Laravel 中，当表单以嵌套 JSON 数组结构（如 identity_cards.0.image）提交文件时，需使用点号（.）语法而非方括号（[]）访问 request->file()，否则无法正确解析上传的文件对象。
在 laravel 中，当表单以嵌套 json 数组结构（如 `identity_cards.0.image`）提交文件时，需使用点号（`.`）语法而非方括号（`[]`）访问 `request->file()`，否则无法正确解析上传的文件对象。
Laravel 的 Illuminate\Http\Request::file() 方法原生支持「点号路径语法」来访问深层嵌套的文件字段，这与 request()->input() 的行为一致，但不兼容传统 PHP 表单的方括号命名方式（如 identity_cards[0][image]）。这是因为 Laravel 内部对文件上传字段的键名做了标准化解析，仅识别 . 分隔的嵌套路径。
✅ 正确用法如下：
// ✅ 获取第一个身份证明的 image 文件
$image = $request->file('identity_cards.0.image');
// ✅ 遍历所有 identity_cards 中的 image 文件
foreach ($request->file('identity_cards.*.image') as $index => $image) {
if ($image && $image->isValid()) {
$path = $image->store('uploads/identity_cards');
// 保存 $path 到数据库等后续处理...
}
}⚠️ 注意事项：
- 确保前端实际以 multipart/form-data 方式提交（不能是纯 JSON POST），且文件字段名严格匹配点号路径（例如 在 HTML 表单中会被 Laravel 自动映射为 identity_cards.0.image）；
- 若使用 Axios 或 Fetch 发送 JSON 数据体（非 FormData），$_FILES 将为空——此时文件不会被 PHP 接收，$request->file() 必然返回 null；必须改用 FormData 构造请求；
- 可通过 $request->hasFile('identity_cards.0.image') 提前校验文件是否存在；
- 多文件场景下，$request->file('identity_cards.*.image') 返回 UploadedFile[] 数组，需逐个验证 isValid() 和 getSize()。
? 总结：Laravel 文件访问遵循「语义化点号路径」原则，拒绝方括号字符串直传；务必确保传输层为 multipart 表单，并善用 hasFile() 与 isValid() 做防御性检查，才能稳健处理嵌套结构中的上传文件。
