切换至Heroku Redis后，Ruby on Rails应用间歇性出现特定SSL错误求助

我之前帮好几个Rails开发者排查过类似的问题——切换到Heroku Redis后间歇性出现OpenSSL::SSL::SSLError: SSL_read: sslv3 alert bad record mac，这种错误大多和客户端配置、连接管理或者服务端的临时状态有关，具体来说有这几个常见原因：

• Redis客户端与Heroku Redis的SSL配置不兼容
  Heroku Redis强制使用TLS 1.2及以上版本的加密连接，如果你的redis gem版本较旧，可能默认启用的SSL版本或加密套件和Heroku Redis的要求不匹配，导致握手或传输过程中偶尔出错。
  解决办法：

  1. 升级redis gem到最新稳定版（建议5.x及以上），在Gemfile中指定：gem 'redis', '~> 5.0'，然后执行bundle update redis。
  2. 确保Redis客户端配置正确开启SSL并验证证书：

     # config/initializers/redis.rb
     Redis.new(
       url: ENV['REDIS_URL'],
       ssl: true,
       ssl_params: {
         verify_mode: OpenSSL::SSL::VERIFY_PEER
         # Heroku Redis的证书由知名CA签发，系统默认信任，无需额外指定ca_file
       }
     )
     

• 连接池的闲置连接被服务端断开
  如果你的应用使用了连接池（比如connection_pool gem），长时间闲置的连接会被Heroku Redis主动回收，但客户端可能还会尝试复用这些已失效的连接，从而触发SSL错误。
  解决办法：

  1. 配置连接池时设置合理的超时时间和重连参数：

     # config/initializers/redis.rb
     $redis_pool = ConnectionPool.new(size: ENV.fetch('REDIS_POOL_SIZE', 5).to_i, timeout: 5) do
       Redis.new(
         url: ENV['REDIS_URL'],
         ssl: true,
         reconnect_attempts: 3,
         connect_timeout: 5,
         read_timeout: 5,
         write_timeout: 5
       )
     end
     

  2. 使用连接池时通过with块获取连接，让连接池自动管理连接的生命周期：

     $redis_pool.with { |conn| conn.get('key') }
     

• Heroku Redis的临时节点切换或网络波动
  作为托管服务，Heroku Redis可能会进行节点故障切换、维护或网络路由调整，这些操作会中断正在进行的SSL连接，导致间歇性错误。
  解决办法：

  1. 查看Heroku Redis的日志，确认是否有服务端的异常记录：

     heroku logs -t --app your-app-name --ps redis
     

  2. 在代码中添加错误捕获和重试逻辑，比如：

     def fetch_redis_key(key)
       $redis_pool.with { |conn| conn.get(key) }
     rescue OpenSSL::SSL::SSLError
       # 重试1次
       sleep 0.1
       $redis_pool.with { |conn| conn.get(key) }
     end
     

• Redis客户端重连逻辑不完善
  旧版本的redis gem在遇到SSL连接错误时，自动重连的逻辑可能存在缺陷，无法及时恢复连接，导致错误抛出。
  解决办法：
  确保redis gem版本在4.0以上（推荐5.x），新版本优化了重连逻辑，能更好地处理SSL连接中断的情况。

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