Postman请求转Guzzle/PHP HTTP客户端报错400/422求解

咱们先拆解下你两次尝试里的问题根源，然后给出正确的实现方案，再推荐几个好用的替代HTTP客户端：

第一种写法（form_params）返回400错误的原因 #

BigCommerce的v3 API明确要求请求体是JSON格式，但form_params参数会把你的数据编码成application/x-www-form-urlencoded格式发送——这和你设置的application/json请求头完全不匹配，API直接判定请求语法错误，所以返回400。这个写法从根本上不符合API的要求，肯定用不了。

第二种写法（JSON参数）返回422错误的原因 #

422错误提示“Missing or incorrect required fields”，问题出在line_items的结构上。BigCommerce的购物车API要求line_items是一个对象数组（哪怕只有一件商品），但你写的是单个对象，没有用数组包裹起来。API接收不到预期的数组结构，就会判定字段不符合要求。

正确的Guzzle实现代码 #

把line_items改成数组包裹的对象，同时加上异常捕获方便排查后续问题：

use GuzzleHttp\Client;
use GuzzleHttp\RequestOptions;

$client = new Client();

try {
    $response = $client->request('POST', 'https://api.bigcommerce.com/stores/ny813bjwdy/v3/carts', [
        'headers' => [
            'Accept' => 'application/json',
            'Content-Type' => 'application/json',
            'X-Auth-Client' => "mzr2qe4qeweqwe",
            'X-Auth-Token' => "nokrq2131qweqrqrqew"
        ],
        RequestOptions::JSON => [
            'customer_id' => 1,
            'line_items' => [ // 这里改成数组包裹单个商品对象
                [
                    'quantity' => 1,
                    'product_id' => 97,
                    'list_price' => 200
                ]
            ]
        ]
    ]);

    // 输出成功响应
    echo "<pre>";
    print_r(json_decode($response->getBody(), true));
    echo "</pre>";
} catch (\GuzzleHttp\Exception\ClientException $e) {
    // 打印完整错误详情用于调试
    echo "<pre>";
    print_r(json_decode($e->getResponse()->getBody(), true));
    echo "</pre>";
}

小提示：加上异常捕获后，你能看到BigCommerce返回的完整错误信息，比只看PHP的致命错误提示更容易定位问题。

其他推荐的PHP HTTP客户端 #

如果觉得Guzzle用着不顺手，这些客户端也很适合调用REST API：

• Symfony HttpClient：Symfony官方出品，轻量且支持异步，依赖少，适合现代PHP项目。
• HTTPful：语法简洁直观，内置JSON处理，上手快，适合快速开发小项目。
• Unirest PHP：跨语言的HTTP客户端，API设计统一，如果你熟悉其他语言的Unirest，切换过来毫无压力。

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