Laravel中Postman提交带头像注册请求无法识别上传文件怎么办

问题背景 #

开发Laravel应用注册接口，接口需接收name、email、username、avatar、password5个参数，自定义表单验证请求类RegisterRequest配置验证规则，控制器中打印请求数据调试时，hasFile('avatar')返回false，无法通过file('avatar')获取上传文件实例。
对应验证规则代码：

public function rules()
{
    return [
        'name'     => 'required',
        'email'    => 'required|email|unique:users,email',
        'username' => 'nullable|string|min:5|unique:users,username',
        'avatar'   => 'nullable|mimes:jpge,jpg,png',
        'password' => 'required|string|min:5',
    ];
}

对应控制器调试代码：

public function register(RegisterRequest $request)
{
    dd(
        $request->all(),
        $request->avatar,
        $request->hasFile('avatar'),
        $request->file('avatar')
    );
}

排查&修复步骤 #

按优先级从高到低依次排查修复：

• 修正Postman请求配置错误
  • 删掉Headers面板中手动添加的Content-Type配置项：Postman选择form-data传参时，会自动生成带正确分段标识的multipart/form-data请求头，手动设置该头（尤其是手动拼接boundary参数）会导致服务端无法正确解析文件内容
  • 检查form-data面板中avatar字段的类型：字段右侧下拉选项必须选File，不能选Text，选Text只会上传文件路径字符串，不会传输真实文件二进制流
  • 清空Body面板下raw标签页的所有配置：单个请求只能使用一种传参格式，同时配置form-data和raw会导致请求体格式混乱，解析失败
• 修正Laravel端代码错误
  • 修复验证规则拼写错误：原规则中图片格式jpge为拼写错误，正确格式为jpeg，修正后avatar验证规则为'avatar' => 'nullable|mimes:jpeg,jpg,png'
  • 检查PHP运行配置：确认php.ini中file_uploads = On，且upload_max_filesize、post_max_size配置值大于上传的头像文件大小，文件大小超限会直接导致文件解析失败
  • 排查自定义中间件影响：检查app/Http/Kernel.php中注册的全局中间件，若存在自定义的请求参数过滤、跨域处理类，可临时注释后测试，排除中间件提前清空上传文件实例的问题

验证方法 #

完成上述修复后重新发起请求，$request->hasFile('avatar')将返回true，$request->file('avatar')可正常获取Illuminate\Http\UploadedFile实例，后续可直接调用store()等方法完成文件存储。

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