Laravel 10：主控制器通过Guzzle传文件至API控制器遇空指针错误

核心原因拆解 #

• Guzzle文件参数传递不规范
  调试时dd($multipart)能看到字段值，不代表Guzzle正确传递了文件资源。Guzzle的multipart文件字段需要包含name、contents（文件资源句柄，比如fopen()返回的资源）、filename的数组结构。如果你只是传递了文件路径字符串，API端无法解析为UploadedFile对象，自然会返回null。

• 临时文件生命周期冲突
  用dd()调试时，程序直接终止，Laravel不会清理请求中的临时文件；但去掉dd()后，请求正常执行，可能在构建Guzzle请求前，临时文件已经被Laravel的请求生命周期自动清理，导致API端接收不到有效文件。

• API端未做存在性校验
  API控制器中直接调用$request->file('cover_photo')->getClientOriginalName()，但没有先判断文件是否存在。一旦Guzzle传递失败，$request->file('cover_photo')返回null，就会触发该错误。

• 表单enctype属性缺失
  编辑页表单如果没设置enctype="multipart/form-data"，即使选择了文件，表单也不会正确上传文件。调试时可能因为临时变量赋值错误显示有值，但实际请求中文件并未被提交。

排查验证步骤 #

1. 检查主控制器中Guzzle的multipart构造逻辑，确保文件字段格式正确：

   [
       'name' => 'cover_photo',
       'contents' => fopen($request->file('cover_photo')->getPathname(), 'r'),
       'filename' => $request->file('cover_photo')->getClientOriginalName()
   ]
   

2. 在API端先校验文件是否存在，再执行后续逻辑：

   if ($request->hasFile('cover_photo')) {
       $filename = $request->file('cover_photo')->getClientOriginalName();
       // 其他文件处理逻辑
   } else {
       // 文件未上传的 fallback 处理
   }
   

3. 确认编辑页表单已添加enctype="multipart/form-data"属性。
4. 避免在Guzzle发送请求前移动或销毁临时文件，确保文件资源在请求发送时仍处于有效状态。

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