RoR环境下如何捕获Redis连接拒绝错误（Errno::ECONNREFUSED）避免生产崩溃

错误原因说明 #

Error connecting to Redis on 127.0.0.1:6379 (Errno::ECONNREFUSED) 该错误直接表明Redis服务未在本地6379端口运行，重启Redis服务即可恢复正常连接：

# 不同系统的Redis重启命令示例
# Ubuntu/Debian
sudo systemctl restart redis-server
# CentOS/RHEL
sudo systemctl restart redis
# MacOS（使用brew安装）
brew services restart redis

RoR生产环境捕获异常的实现方式 #

生产环境中必须对Redis操作添加异常捕获逻辑，避免单个Redis连接失败导致整个应用崩溃，以下是几种实用实现方式：

1. 单个Redis操作添加rescue块 #

在直接调用Redis客户端的代码处，精准捕获连接异常：

def fetch_cached_user_profile(user_id)
  begin
    Redis.current.get("user:#{user_id}:profile")
  rescue Errno::ECONNREFUSED, Redis::CannotConnectError => e
    # 记录错误日志便于排查
    Rails.logger.error "Redis连接失败: #{e.message}"
    # 降级处理：从数据库获取数据作为替代
    User.find(user_id).profile.to_json
  end
end

2. 封装Redis操作统一处理异常 #

将所有Redis操作封装到服务类中，统一管理异常逻辑：

class RedisCacheService
  class << self
    def get(key)
      execute_operation { Redis.current.get(key) }
    end

    def set(key, value, expires_in: nil)
      execute_operation do
        expires_in ? Redis.current.setex(key, expires_in, value) : Redis.current.set(key, value)
      end
    end

    private

    def execute_operation
      yield
    rescue Errno::ECONNREFUSED, Redis::CannotConnectError => e
      Rails.logger.error "Redis操作失败: #{e.message}"
      nil # 或返回自定义降级默认值
    end
  end
end

使用时直接调用封装后的方法：

RedisCacheService.get("product:123:stock")

3. 全局异常兜底处理 #

在application_controller.rb中添加全局异常捕获，处理未被局部捕获的Redis连接异常：

class ApplicationController < ActionController::Base
  rescue_from Errno::ECONNREFUSED, Redis::CannotConnectError do |e|
    Rails.logger.error "全局捕获Redis连接异常: #{e.message}"
    # 根据请求类型返回对应响应
    if request.format.json?
      render json: { error: "缓存服务暂时不可用" }, status: :service_unavailable
    else
      render "errors/service_unavailable", status: :service_unavailable
    end
  end
end

注意事项 #

• 捕获异常后必须记录详细错误日志，便于快速定位Redis服务状态问题
• 必须设计降级方案（如从数据库取数、返回默认值），保障核心业务流程正常运行
• 生产环境建议配置Redis服务自动重启（如systemd的Restart=always配置），减少人工干预成本

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