如何解决本地调用HTTPS接口出现的SSL错误1408F10B

核心错误原因 #

1408F10B:SSL routines:ssl3_get_record:wrong version number 这类错误通常是客户端与服务器的SSL/TLS版本协商失败，或者错误地用HTTPS协议访问了HTTP端口导致的。

逐步排查与解决方法 #

1. 确认URL端口与解析正确性 #

• 检查HTTPS URL的端口：默认HTTPS端口是443，如果对方用了非标准端口，必须在URL里明确指定（比如https://xxx.com:8443）。
• 对比域名解析结果：执行ping your-third-party-domain.com，如果IP和同事的不一致，说明本地DNS解析出错，可临时修改hosts文件指定正确IP测试。
• 用verbose模式看curl连接细节：执行curl -v https://your-third-party-url.com，确认输出里是否有* Connected to xxx (xxx.xxx.xxx.xxx) port 443 (#0)，如果是port 80，说明你实际连的是HTTP端口，必然触发SSL版本错误。

2. 强制指定curl的TLS版本 #

本地curl默认的TLS版本可能和服务器不兼容，可在代码里强制指定兼容版本：

• 优先尝试TLSv1.2（大部分服务器都支持）：

  curl_setopt($curl, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_2);
  

• 如果无效，再试TLSv1.3：

  curl_setopt($curl, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_3);
  

3. 修正代码中的错误处理逻辑 #

你当前代码在curl_close($curl)之后才调用curl_error($curl)，此时curl资源已经被释放，拿不到正确的错误信息。必须把错误处理放在curl_close之前：

// 正确顺序
$resp = curl_exec($curl);
$error_msg = curl_error($curl); // 先获取错误信息
curl_close($curl); // 再关闭资源

4. 检查本地SSL库版本兼容性 #

不同SSL库（OpenSSL/BoringSSL）或旧版本库可能存在协商问题：

• 执行curl --version查看本地curl使用的SSL库及版本，比如：

  curl 7.68.0 (x86_64-pc-linux-gnu) libcurl/7.68.0 OpenSSL/1.1.1f zlib/1.2.11
  

• 如果你的版本远低于同事，建议更新curl或SSL库。

5. 本地Postman客户端临时测试方案 #

Postman客户端的SSL栈和浏览器（网页版Postman）不同，可尝试：

• 在请求设置里关闭「SSL certificate verification」（仅用于测试，生产环境不要关闭）。
• 在「Settings > General」中，调整「TLS version」为强制TLSv1.2或TLSv1.3。

修正后的完整PHP代码示例 #

<?php
$url = "https://your-third-party-url.com";
$curl = curl_init($url);

// 基础配置
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

// 强制指定TLS版本
curl_setopt($curl, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_2);

// 生产环境请勿开启，仅测试用
// curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

// 请求头与数据
$headers = array(
   "Content-Type: application/json",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);

$data = '{"to":"eyJpdiI6InFvVDUvNUp2aWdmcjBGaytTaS84alE9PSIsInZhbHVlIjoiK29aVlBhNk5TRVgzb2Z3Qm45cHB5L1hSZEYwMWxTajhMSDJDWHlIOXpRMD0iLCJtYWMiOiIwYmExYzczMjM1NjUxZjBiNzdmMWE2YjhlODQxZjMzODQ5NWYyYThhMTQ5YWIwODhkOTA0ZTczNzQxYjc2NDhiIiwidGFnIjoiIn0=","from":"+123456789","isTemplate":"1","message":"hello","agent":"test"}';
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);

// 执行请求并处理错误
$resp = curl_exec($curl);
$error_msg = curl_error($curl);
curl_close($curl);

var_dump($resp);
if (!empty($error_msg)) {
    echo "CURL错误: " . $error_msg;
}
?>

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