Laravel在安卓/iOS Chrome上传文件时hasFile未识别问题

针对移动端Chrome上传文件时$request->hasFile('photos')判断失效、桌面端却正常的问题，大概率是请求格式、文件数组处理或上传限制配置的问题，以下是针对性的解决方案：

1. 确保请求的multipart格式正确 #

• 传统表单上传必须添加enctype="multipart/form-data"属性，移动端Chrome对该属性的校验更严格，缺失会导致文件无法被后端正确解析：

  <form method="POST" action="/posts" enctype="multipart/form-data">
      <!-- 其他表单字段 -->
      <input type="file" name="photos[]" multiple>
  </form>
  

• AJAX上传时不要手动设置Content-Type，直接使用FormData对象提交，让浏览器自动处理multipart格式：

  const formData = new FormData(document.querySelector('form'));
  // 禁止手动设置Content-Type，避免格式错误
  fetch('/posts', { method: 'POST', body: formData });
  

2. 兼容单文件/多文件的数组格式问题 #

移动端Chrome在仅选择单个文件时，可能会自动将photos[]的参数名转为photos（而非数组格式），导致$request->hasFile('photos')无法识别为多文件数组。修改store方法的判断逻辑，兼容两种场景：

public function store(Request $request)
{
    ...
    $photos = [];
    // 同时兼容单文件和多文件上传的情况
    if ($request->hasFile('photos')) {
        $photos = is_array($request->file('photos')) ? $request->file('photos') : [$request->file('photos')];
    }

    if (!empty($photos)) {
        $this->createPhotos($post, $photos);
    }
    ...
}

同时在createPhotos方法开头添加数组兼容处理，避免单个文件时遍历出错：

public function createPhotos(Post $post, $photos)
{
    // 确保传入的始终是数组格式
    $photos = is_array($photos) ? $photos : [$photos];
    
    foreach ($photos as $photo) {
        // 原文件处理逻辑保持不变
    }
}

3. 检查上传大小限制 #

移动端拍摄的图片尺寸通常较大，容易触发PHP或Laravel的上传限制，导致文件被截断，$request->hasFile返回false：

• 修改php.ini配置（根据服务器环境调整路径）：

  upload_max_filesize = 10M
  post_max_size = 10M
  

• 在Laravel请求验证中添加大小限制，提前拦截不符合要求的文件：

  public function store(Request $request)
  {
      $request->validate([
          'photos.*' => 'file|image|max:10240', // 限制10MB，可按需调整
      ]);
      ...
  }
  

4. 日志排查定位问题 #

如果以上方案无效，可以在store方法中添加日志，查看移动端请求实际接收的文件数据：

use Illuminate\Support\Facades\Log;

public function store(Request $request)
{
    Log::info('Mobile upload files:', $request->files()->all());
    Log::info('Mobile request data:', $request->all());
    ...
}

通过日志可以明确是否接收到photos字段，以及字段格式是否符合预期，进一步精准定位问题。

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