Laravel中Base64解码图片存储至本地后损坏的解决求助

• 清理Base64前缀
  前端传的Base64字符串大多带data:image/xxx;base64,前缀，直接解码会把前缀当成图片数据，导致文件损坏。先移除前缀，同时处理URL安全的Base64编码和填充字符：

  // 移除常见的图片Base64前缀
  $imgData = str_replace([
      'data:image/jpeg;base64,',
      'data:image/png;base64,',
      'data:image/gif;base64,'
  ], '', $validatedData['img']);
  
  // 处理URL安全的Base64（替换-为+，_为/）
  $imgData = str_replace(['-', '_'], ['+', '/'], $imgData);
  
  // 补全Base64必需的填充字符=
  $imgData = str_pad($imgData, strlen($imgData) + (4 - strlen($imgData) % 4) % 4, '=');
  
  // 解码，第二个参数设为true，解码失败直接返回false
  $imgData = base64_decode($imgData, true);
  

• 验证解码有效性
  解码后必须检查是否成功，避免无效数据写入文件：

  if ($imgData === false) {
      throw new \Exception('传入的Base64图片数据无效');
  }
  

• 匹配真实文件格式与后缀
  不要硬写.jpg后缀，如果前端传的是PNG/GIF，存成.jpg会导致文件损坏。通过二进制数据判断真实格式：

  $finfo = new \finfo(FILEINFO_MIME_TYPE);
  $mime = $finfo->buffer($imgData);
  
  $ext = match($mime) {
      'image/jpeg' => '.jpg',
      'image/png' => '.png',
      'image/gif' => '.gif',
      default => throw new \Exception('不支持的图片格式')
  };
  
  $uniqueFilename = hash('sha256', time() . $imgData) . $ext;
  

• 强制二进制模式存储
  确保Laravel用二进制模式写入文件，避免编码转换导致数据损坏：

  Storage::disk('public')->put('products/' . $uniqueFilename, $imgData, 'binary');
  

• 校验存储完整性
  存储后对比原数据和存储的数据，确认没有丢失：

  $storedData = Storage::disk('public')->get('products/' . $uniqueFilename);
  if ($storedData !== $imgData) {
      throw new \Exception('文件存储过程中数据丢失，请检查存储配置');
  }
  

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