Rails应用连接Elastic Cache(Redis)缓存的配置与问题排查

当前配置连接失败、报错连接127.0.0.1的核心原因有三点：

• 配置哈希使用了字符串键（"url"、"port"），Redis.new 仅识别符号类型的配置键，传入字符串键时所有自定义配置不会生效，客户端会直接走默认值127.0.0.1:6379，触发本地连接被拒的错误
• 缺少TLS加密配置，你用redis-cli连接时加了--tls参数，说明ElastiCache开启了传输加密，客户端必须显式开启SSL才能正常连接
• 没有传入鉴权token参数，缺少redis-cli中-a对应的密码配置
• 额外说明：redis-rails gem已停止维护多年，Rails 5.2及以上版本已原生支持Redis作为缓存存储，无需额外引入该依赖。

1. 依赖配置 #

首先移除Gemfile中无用的redis-rails相关依赖，仅保留官方Redis客户端即可：

# Gemfile
gem 'redis', '~> 4.8' # 5.x版本同样兼容

执行bundle install完成依赖安装。

2. 直连Redis客户端配置 #

如果需要单独初始化Redis客户端做业务存储（比如token存储），使用如下配置：

REDIS_CONFIG = {
  host: 'primary-endpoint', # 替换为你的ElastiCache主节点地址，不要加redis://前缀
  port: 6379,
  password: 'token', # 替换为你redis-cli -a后传入的鉴权token
  ssl: true, # 对应--tls参数，开启传输加密
  ssl_params: { verify_mode: OpenSSL::SSL::VERIFY_NONE }, # ElastiCache默认证书链不需要客户端强制校验，如遇证书报错可保留该配置
  connect_timeout: 10
}

@redis_token_store ||= Redis.new(REDIS_CONFIG)
# 连接测试，返回"PONG"即为配置生效
@redis_token_store.ping

3. Rails缓存存储配置 #

如果是作为Rails应用的默认缓存存储，直接在对应环境的配置文件（比如config/environments/production.rb）中添加如下配置即可，无需手动初始化Redis客户端：

config.cache_store = :redis_cache_store, {
  host: 'primary-endpoint',
  port: 6379,
  password: 'token',
  ssl: true,
  ssl_params: { verify_mode: OpenSSL::SSL::VERIFY_NONE },
  connect_timeout: 30,
  read_timeout: 5,
  write_timeout: 5,
  reconnect_attempts: 2
}

• 确认网络策略配置：应用所在实例的安全组需要允许出站到ElastiCache 6379端口的流量，ElastiCache的安全组需要允许来自应用侧安全组的6379端口入站流量
• 如果使用的是集群模式（Cluster Mode Enabled）的ElastiCache Redis，需要替换为redis-clustering客户端，配置中替换为cluster: ["primary-endpoint:6379"]参数即可，单节点/主从模式不需要该调整
• 所有配置键必须使用Ruby符号格式（即:host、:port这类带冒号的格式），禁止使用字符串作为配置键，否则配置不会被客户端读取

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