Rails应用用httparty跨服务器调API遇SSL协议版本错误排查

这个错误我之前排查过好多次！本质是你新服务器上的Ruby或OpenSSL环境默认使用的TLS版本太旧，和目标API服务器要求的版本不匹配——现在绝大多数公开API都只支持TLS 1.2及以上版本，而旧服务器上的Ruby可能还默认启用TLS 1.0/1.1，导致握手失败。

快速验证问题根源 #

先在新服务器上执行这个命令，确认当前Ruby环境支持的最低TLS版本：

ruby -ropenssl -e 'puts OpenSSL::SSL::SSLContext.new.min_version'

如果输出是TLS1_0或者更低，那百分百是版本兼容问题。

解决方案一：在HTTParty请求中强制指定TLS版本 #

这是最快的临时修复方案，直接在你的请求里添加ssl_version参数，强制使用API支持的TLS版本（优先试TLS 1.2，不行再试1.3）：

修改你的代码如下：

require 'httparty'
require 'pp'
require 'openssl'

def self.get_token
  include HTTParty
  base_uri = self.base_url + 'oauth/token' # 简化路径拼接
  response = HTTParty.post(
    base_uri,
    verify: false, # 注意：生产环境建议去掉此参数，配置正确的证书信任
    ssl_version: :TLSv1_2, # 关键：强制使用TLS 1.2
    body: {
      grant_type: 'password',
      client_id: '3',
      client_secret: 'eGSjPBZV70IsJwnyjNn7EYI6vci0bGrFbJkJNVof',
      password: 'Passw0rd!',
      username: 'myemail@gmail.com'
    }
  )
  token = response.parsed_response['access_token']
  return token
end

解决方案二：升级服务器的Ruby和OpenSSL版本 #

如果长期运行，建议彻底升级环境，避免后续遇到更多SSL相关问题：

• Ruby版本：升级到2.4及以上（Ruby 2.4+默认启用TLS 1.2），推荐用rbenv或rvm来管理Ruby版本，避免破坏系统默认Ruby。
• OpenSSL版本：确保服务器上的OpenSSL是1.0.2及以上版本（1.0.1及更早版本已停止安全支持），可以通过openssl version命令查看，若版本过低，需要通过包管理器（如apt、yum）升级。

额外注意事项 #

• 尽量不要在生产环境保留verify: false，这会跳过SSL证书验证，存在安全风险。如果API使用的是自定义证书，你可以通过cert_store参数指定信任的证书。
• 如果强制TLS 1.2还是失败，可以尝试:TLSv1_3，但需要确认目标API服务器支持该版本。

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