Symfony4.4使用HttpClient调用Saferpay支付接口返回401未授权如何解决

• 手动指定Content-Type头和自定义JSON编码的body可能和HttpClient自动处理逻辑冲突：Symfony HttpClient提供了json参数直接传入数组，会自动完成JSON编码、设置Content-Type: application/json头，手动设置可能因为字符集声明等细节触发网关鉴权规则异常。
• 检查HttpClient全局配置是否覆盖鉴权头：如果在config/packages/framework.yaml中配置了http_client的默认headers或auth参数，会优先使用全局配置，覆盖你在单次请求中传入的auth_basic参数。
• 密码含特殊字符的转义问题：如果你的Saferpay接口密码包含:、@、空格等特殊字符，部分低版本HttpClient的自动base64编码逻辑可能出现转义异常，可手动生成Authorization头规避。

/**
 * @Route("/checkout", name="app_checkout")
 */
public function initializePayment()
{
    $payload = array(
        "RequestHeader" => array(
            "SpecVersion" => "1.7",
            "CustomerId" => "307998",
            "RequestId" => "0a71fa0241d68c49387f8aee8f982a7b",
            "RetryIndicator" => 0
        ),
        "TerminalId" => "17735964",
        "Payment" => array(
            "Amount" => array(
                "Value" => "100",
                "CurrencyCode" => "EUR"
            ),
            "OrderId" => "123test",
            "Description" => "Test_Order_123test"
        ),
        "ReturnUrls" => array(
            "Success" => "localhost:8000",
            "Fail" =>  "localhost:8000"
        )
    );

    // 调试用：手动生成鉴权头，替换自动auth_basic参数
    // $auth = base64_encode('API_258086_74490074:THE PASSWORD');

    $request = $this->client->request(
        'POST',
        'https://test.saferpay.com/api/Payment/v1/PaymentPage/Initialize',
        [
            'headers' => [
                'Accept' => 'application/json',
                // 调试用：手动加鉴权头
                // 'Authorization' => 'Basic ' . $auth,
            ],
            'auth_basic' => ['API_258086_74490074', 'THE PASSWORD'],
            // 直接用json参数传数组，替代手动json_encode和手动设置Content-Type
            'json' => $payload
        ]
    );

    // 调试用：打印实际发送的请求头，确认鉴权信息是否正确
    // dd($request->getInfo('request_headers'));
}

如果修改后还是报错，打开代码中注释的手动鉴权头代码，替换auth_basic参数，同时打印请求头确认Authorization字段是否符合预期，排查是否有全局配置覆盖的情况。

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