如何使用Guzzle发送包含文件字段的JSON格式multipart请求？

问题根因 #

你当前的写法是把documents整个结构序列化为JSON字符串作为multipart的单个字段提交，服务端的表单解析器默认不会自动解析这个JSON字符串为嵌套结构，因此会判定documents字段未传递，触发必填校验报错。另外注意你提到的404错误大概率是笔误，参数校验失败对应的状态码是400 Bad Request，如果确实返回404请先核对接口地址、请求方法是否正确。

解决方案 #

根据你服务端的接口约定，选择以下两种方案之一即可： #

方案1：拆分嵌套字段为表单数组格式（适用于绝大多数同时传文件+表单参数的场景）

如果你的dossier_initial是需要上传的文件，直接把documents下的所有子字段拆成带数组标识的multipart字段即可，服务端可以直接解析为嵌套结构：

$httpClient = new Client();
$token = 'Token 7480ea9a692f98ad943e810820ced48aa09ca174';
$response =  $httpClient->post('http://127.0.0.1:8000/api_memoire/signed/', [
    'headers' => [
        'Authorization' => $token,
        'Accept'        => 'application/json',
    ],
    'multipart' => [
        [
            'name' => 'documents[id_proprietaire]',
            'contents' => $id_demande,
        ],
        [
            'name' => 'documents[nom_proprietaire]',
            'contents' => $demande->nom,
        ],
        [
            'name' => 'documents[prenom_proprietaire]',
            'contents' => $demande->prenoms,
        ],
        [
            'name' => 'documents[code_identification]',
            'contents' => $code,
        ],
        // 上传文件请传入文件资源，不要直接传路径字符串
        [
            'name' => 'documents[dossier_initial]',
            'contents' => fopen($document, 'r'),
            'filename' => basename($document),
            'headers'  => [
                'Content-Type' => mime_content_type($document)
            ]
        ],
        [
            'name' => 'dossier_final',
            'contents' => null,
        ]
    ]
]);

方案2：为JSON字段声明内容类型（适用于服务端要求直接传JSON字符串的场景）

如果接口明确要求documents字段传递JSON字符串，需要为该字段单独添加Content-Type头声明内容格式，方便服务端识别解析：

$httpClient = new Client();
$token = 'Token 7480ea9a692f98ad943e810820ced48aa09ca174';
$documentsJson = json_encode([
    'id_proprietaire' => $id_demande,
    'nom_proprietaire' => $demande->nom,
    'prenom_proprietaire' => $demande->prenoms,
    'code_identification' => $code,
    'dossier_initial' => $document,
]);

$response =  $httpClient->post('http://127.0.0.1:8000/api_memoire/signed/', [
    'headers' => [
        'Authorization' => $token,
        'Accept'        => 'application/json',
    ],
    'multipart' => [
        [
            'name' => 'documents',
            'contents' => $documentsJson,
            'headers' => [
                'Content-Type' => 'application/json'
            ]
        ],
        [
            'name' => 'dossier_final',
            'contents' => null,
        ]
    ]
]);

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