Laravel 5.1表单上传图片无法持久化至控制器问题排查

基于你描述的问题场景，我来分享下排查过程和最终的解决方案：

问题概述 #

在使用Laravel 5.1进行图片上传开发时，遇到了一个诡异的问题：两个结构类似的表单，右侧表单能正常完成图片上传，左侧表单却完全无法生效，且已确认两个表单的标签闭合均无错误。当前Laravel的最新版本为5.6。

表单对比（示例） #

左侧为失效表单，右侧为正常工作表单

• 左侧失效表单：

<form method="POST" action="/image-upload" enctype="multipart/form-data">
    {{ csrf_field() }}
    <input type="file" name="avatar">
    <button type="submit">提交上传</button>
</form>

• 右侧正常表单：

<form method="POST" action="/valid-upload" enctype="multipart/form-data">
    {{ csrf_field() }}
    <input type="file" name="avatar">
    <button type="submit">提交上传</button>
</form>

对应控制器方法 #

// 处理上传的控制器方法示例
public function handleUpload(Request $request)
{
    // 验证文件是否存在且有效
    if ($request->hasFile('avatar') && $request->file('avatar')->isValid()) {
        $storagePath = $request->file('avatar')->store('avatars');
        return response()->json([
            'status' => 'success',
            'storage_path' => $storagePath
        ]);
    }

    return response()->json([
        'status' => 'error',
        'message' => '未检测到有效上传文件'
    ]);
}

请求返回结果 #

• 左侧失效表单提交后返回：

{"status":"error","message":"未检测到有效上传文件"}

• 右侧正常表单提交后返回：

{"status":"success","storage_path":"avatars/abc123.jpg"}

最终解决方案 #

经过各种排查（包括路由配置、表单属性、请求头检查）都没有找到问题根源后，我尝试新建一个控制器，将原控制器的代码完整复制到新控制器中，并修改左侧表单的提交路由指向新控制器的对应方法。神奇的是，此时左侧表单可以正常处理图片上传了！

推测问题根源是Laravel 5.1的类加载缓存或者路由缓存导致原控制器出现了加载异常，新建控制器相当于重新注册了类实例，从而绕过了缓存异常，解决了表单失效的问题。

内容的提问来源于stack exchange，提问作者Tuomas Tuokkola