Paypal Sandbox SSL握手错误：Curl请求失败报sslv3 alert handshake failure

老哥，这个SSL握手失败的问题我太熟了——PayPal沙箱早就强制要求使用TLSv1.2了，正式环境也马上要跟进，你遇到的error:14077410:SSL routines:SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure，本质就是你的curl请求没用到符合要求的TLS版本，直接被PayPal的服务器拦了。

常见的触发原因 #

• 你的curl版本太旧：早期curl版本默认启用的TLS版本偏低，甚至可能还在用SSLv3或者TLSv1.0，完全不支持TLSv1.2
• 系统OpenSSL库版本不达标：TLSv1.2需要OpenSSL 1.0.1c及以上版本支持，如果你的系统里的OpenSSL版本低于这个，哪怕curl想调用也没辙
• 没有手动指定TLSv1.2：有些环境下curl不会自动启用最高可用的TLS版本，必须手动明确指定

可行的解决步骤 #

1. 检查并升级curl和OpenSSL版本
   先运行curl -V查看当前版本，看看输出里的OpenSSL版本是不是1.0.1c以上，同时curl版本最好是7.34.0及以上（这个版本开始默认支持TLSv1.2）。

   • Ubuntu/Debian系统升级命令：sudo apt update && sudo apt install curl openssl
   • CentOS/RHEL系统升级命令：sudo yum update curl openssl
   • Windows直接下载最新版的curl安装包替换旧版本即可

2. 在curl请求里强制指定TLSv1.2
   不管版本够不够，加上这个参数更保险，避免环境默认配置拖后腿：

   curl --tlsv1.2 https://api.sandbox.paypal.com/your-target-endpoint
   

   如果是用代码调用curl库（比如PHP的cURL扩展），也要在代码里设置对应选项：

   $ch = curl_init();
   curl_setopt($ch, CURLOPT_URL, 'https://api.sandbox.paypal.com/your-target-endpoint');
   curl_setopt($ch, CURLOPT_SSLVERSION, CURL_SSLVERSION_TLSv1_2);
   // 添加其他必要配置：请求头、POST数据、超时设置等
   $response = curl_exec($ch);
   curl_close($ch);
   

3. 排查系统SSL全局配置
   有些Linux系统会在/etc/ssl/openssl.cnf里限制可用的TLS版本，检查配置文件里的MinProtocol参数，确保设置为MinProtocol = TLSv1.2，如果有禁用TLSv1.2的配置，直接删掉或者修改后重启相关服务。

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