Laravel 5.8上传文件时$request->hasFile()始终返回false问题排查

嘿，我帮你理清这个问题的来龙去脉啦，咱们一步步看：

问题场景还原 #

你在Laravel 5.8项目里做文件上传，不管传什么类型的文件，$request->hasFile('featured_img')一直返回false。已经做了这些排查：

• 表单加了enctype="multipart/form-data"
• 测试了50-80KB的小文件
• 同环境下其他Laravel应用能正常上传，排除php.ini配置问题
• 用dd($request->all())查看请求数据，发现featured_img是字符串文件名，而不是预期的文件对象

最后终于找到问题根源：视图页面里存在两个提交到同一路由的表单！

为什么会出现这个问题？ #

当页面中有两个表单都指向同一个路由（比如这里的items.store），并且表单里有同名的字段（比如都叫featured_img），浏览器在处理表单提交时会出现字段冲突，导致文件上传的真实数据被覆盖，服务器端接收到的就只是一个字符串文件名，而不是Illuminate\Http\UploadedFile对象，自然$request->hasFile()会返回false。

你的相关代码参考 #

表单代码 #

<form action="{{ route('items.store') }}" method="POST" enctype="multipart/form-data">
@csrf
<div class="form-group py-50">
<input type="file" name="featured_img" value="featured_img" id="featured_img">
</div>
<div class="form-group">
<input type="submit" class="btn btn-primary" value="Upload Image" name="submit">
</div>
</form>

控制器代码 #

/**
* Store a newly created resource in storage.
*
* @param \Illuminate\Http\Request $request
* @return \Illuminate\Http\Response
*/
public function store(Request $request)
{
//Check if image has been uploaded
if($request->hasFile('featured_img')){
return "True!";
} else {
return "False!";
}
}

dd($request->all())输出 #

array:7 [▼
"_token" => "sREFSO8bs0rWil05AESVrwEl37XtKOJAF2nCkTNR"
"status" => "published"
"featured_img" => "example.jpg"
"submit" => "Upload Image"
]

注意：正常情况下featured_img应该是Illuminate\Http\UploadedFile实例，这里显示字符串就说明文件数据没被正确传递。

解决方案 #

1. 清理重复表单：找到视图里另一个指向items.store路由的表单，要么移除它，要么修改它的提交路由，确保每个表单的目标路由唯一。
2. 避免字段冲突：如果确实需要两个表单提交到同一路由，给它们的字段加上不同的前缀（比如form1_featured_img和form2_featured_img），或者用不同的命名空间区分，防止字段名重复导致数据覆盖。
3. 优化文件输入框：表单里的文件input不要加value属性，因为文件输入框的value是只读的，手动设置value="featured_img"毫无意义，还可能引发异常，建议改成：

   <input type="file" name="featured_img" id="featured_img">
   

内容的提问来源于stack exchange，提问作者Eric S.