Laravel HTTP发送文件至第三方API时对方接收文件异常求助

针对你遇到的第三方API收到不完整文件但返回成功响应的问题，以下是关键排查点和修复方案：

1. 文件名拼接错误（核心问题） #

你当前用Storage::mimeType()获取的是文件MIME类型（比如image/jpeg），拼接后文件名会变成firstupload.image/jpeg，这种格式不符合规范，会导致第三方解析文件时出错，表现为文件不完整。

应该改用Storage::extension()获取文件扩展名：

'firstupload.' . Storage::extension('/uploads/firstupload.jpeg')

2. 避免直接读取文件内容到内存 #

使用Storage::get()会把整个文件读入内存，大图片可能因内存限制或传输截断导致文件不完整。推荐直接传入文件路径或资源流给attach方法，Laravel会自动处理读取和传输：

方案一：传入文件资源流 #

->attach(
    'firstupload',
    fopen(Storage::path('/uploads/firstupload.jpeg'), 'r'),
    'firstupload.' . Storage::extension('/uploads/firstupload.jpeg')
)

方案二：直接传入存储路径（Laravel 8+支持） #

若存储磁盘配置正确，可直接传入文件路径：

->attach(
    'firstupload',
    Storage::path('/uploads/firstupload.jpeg'),
    'firstupload.' . Storage::extension('/uploads/firstupload.jpeg')
)

3. 修复后的完整代码 #

$request = Http::withHeaders([
        'Accept' => 'application/json',
    ])
    ->attach(
        'firstupload',
        fopen(Storage::path('/uploads/firstupload.jpeg'), 'r'),
        'firstupload.' . Storage::extension('/uploads/firstupload.jpeg')
    )
    ->attach(
        'secondupload',
        fopen(Storage::path('/uploads/secondupload.jpeg'), 'r'),
        'secondupload.' . Storage::extension('/uploads/secondupload.jpeg')
    )
    ->post('https://thirdpartyapi.com/fileUpload', [
        'uploadType' => 'imageUpload',
    ]);

额外排查点 #

• 检查本地文件完整性：对比本地文件字节大小和strlen(Storage::get(...))的结果，确认读取内容无截断。
• 匹配第三方API要求：若对方需要指定文件MIME类型，可在attach中补充第四个参数：

  ->attach(
      'firstupload',
      fopen(Storage::path('/uploads/firstupload.jpeg'), 'r'),
      'firstupload.jpeg',
      ['Content-Type' => Storage::mimeType('/uploads/firstupload.jpeg')]
  )
  

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