使用GuzzleHTTP POST文件报错：part was null 求助

我之前踩过一模一样的坑，Postman能正常跑但Guzzle代码就报500，核心问题出在两个细节上：手动设置Content-Type头干扰了Guzzle的自动处理，以及文件内容的传递方式不符合Guzzle的要求。

问题拆解 #

1. 当使用Guzzle的multipart选项时，框架会自动生成带正确boundary分隔符的multipart/form-data请求头，手动硬编码这个头会覆盖自动生成的内容，导致服务端无法正确解析表单数据。
2. 直接把Laravel的Illuminate\Http\File对象丢给contents字段，Guzzle没法正确读取文件内容，最终服务端收到的文件部分就是null。

修复后的代码 #

public function storeImagesInAmazon(Request $request) {
    $uploadFilePath = 'some/endpoint';
    $file = $request->file('file');
    
    // 先做基础校验：确认文件上传有效
    if (!$file->isValid()) {
        return response()->json(['error' => '上传的文件无效'], 400);
    }

    $client = new Client();
    $response = $client->request('POST', $uploadFilePath, [
        'headers' => [
            'Accept' => 'application/json',
            // 移除手动设置的Content-Type，交给Guzzle自动处理
        ],
        'multipart' => [
            [
                'name' => 'file',
                'contents' => fopen($file->getPathname(), 'r'), // 使用文件流传递内容
                'filename' => $file->getClientOriginalName() // 带上原始文件名，和Postman行为对齐
            ]
        ]
    ]);
    
    $result = json_decode($response->getBody(), true);
    return [
        'hashedID' => $result['hashedID']
    ];
}

额外调试技巧 #

如果还是有问题，可以开启Guzzle的调试模式，把实际发送的请求内容打印出来，和Postman的请求做对比：

// 创建Client时开启调试
$client = new Client(['debug' => true]);

控制台会输出完整的请求头和表单数据，能快速定位和Postman的差异点。

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