PHP使用SoapClient调用Correios WebService加载超时无报错如何解决

核心原因排查 #

• 浏览器能访问WSDL不代表PHP进程有权限发起对外HTTPS请求，常见为服务器防火墙拦截出站请求、DNS解析异常、未配置请求超时规则导致进程无限挂起
• 未开启PHP错误显示，底层报错被静默隐藏
• SOAP请求参数结构不符合接口要求

解决步骤 #

1. 先开启全量错误提示 #

在代码开头加入以下配置，确保所有报错都能输出：

error_reporting(E_ALL);
ini_set('display_errors', 1);
ini_set('default_socket_timeout', 10); // 全局默认socket超时10秒，避免无限等待

2. 补充SoapClient超时配置 #

在原有$options里新增连接超时配置，同时先测试PHP能否正常获取WSDL内容：

// 先测试PHP网络连通性，执行后如果能输出WSDL内容说明网络正常，超时则是网络层面问题
$wsdl = 'https://ws.correios.com.br/calculador/CalcPrecoPrazo.asmx?WSDL';
var_dump(file_get_contents($wsdl));

$options = [
    'cache_wsdl'        => WSDL_CACHE_NONE,
    'trace'             => 1,
    'connection_timeout' => 10, // 连接超时10秒
    'stream_context'    => stream_context_create(
        [
            'ssl' => [
                'verify_peer'       => false,
                'verify_peer_name'  => false,
                'allow_self_signed' => true
            ],
            'http' => [
                'timeout' => 10 // 请求超时10秒
            ]
        ]
    )
];

$client = new SoapClient($wsdl, $options);

// 先打印接口支持的方法和参数结构，确认传参格式是否正确
var_dump($client->__getFunctions());

$parametros = [
    'nCdServico' => '04510', 
    'sCepOrigem' => '82220020', 
    'sCepDestino' => '08090284'
];

// 部分SOAP服务要求参数包裹在方法名对应的键下，可两种写法都测试
$response = $client->CalcPrazo(['CalcPrazo' => $parametros]);
// 也可测试原写法 $response = $client->CalcPrazo($parametros);

var_dump($response);

3. 网络问题修复 #

如果上述file_get_contents测试就超时，直接联系你的服务器提供商/运维，确认是否放开了对ws.correios.com.br 443端口的出站请求限制，排查DNS解析是否正常。

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