Rails 7.0.4 ActionCable在Elastic Beanstalk生产环境连接异常求助

问题概述 #

基于Rails 7.0.4（Ruby 3.0.5，Amazon Linux 2/3.6.3）开发的聊天功能，使用ActionCable+Turbo Stream对接OpenAI，开发环境运行正常，但生产环境下/cable的WebSocket连接会意外断开。最初遇到404错误，添加NGINX配置后解决，但随即出现499错误，必须刷新页面才能获取更新。Redis配置采用AWS Elasticache端点，已验证该端点可正常用于Sidekiq，尝试过允许所有请求源、开启LB粘性、切换TCP监听器等操作均无效。

以下是针对性的排查与解决建议：

1. 补全NGINX的WebSocket代理配置 #

499错误多与连接超时或代理主动断开有关，原配置缺少关键的超时与缓冲区设置，补充后可避免代理截断长连接：

location /cable {
  proxy_pass http://my_app;
  proxy_http_version 1.1;
  proxy_set_header Upgrade websocket;
  proxy_set_header Connection "upgrade";
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  # 添加WebSocket长连接维持配置
  proxy_connect_timeout 7d;
  proxy_send_timeout 7d;
  proxy_read_timeout 7d;
  proxy_buffering off;
  proxy_cache off;
}

2. 修正ActionCable生产环境配置 #

避免使用通配符允许请求源，明确指定域名更可靠，同时确保WebSocket地址配置正确：

# config/environments/production.rb
config.action_cable.url = ENV.fetch("ACTION_CABLE_URL", "wss://#{ENV['RAILS_HOST']}/cable")
config.action_cable.allowed_request_origins = [ENV['RAILS_HOST']]

在Elastic Beanstalk环境变量中设置RAILS_HOST为你的应用域名，ACTION_CABLE_URL可根据实际情况调整。

3. 排查Elasticache Redis的连接限制 #

尽管Sidekiq能正常连接，ActionCable对Redis的连接仍需额外验证：

• 检查Elasticache安全组是否允许Elastic Beanstalk实例所在安全组访问6379端口
• 确认Redis配置中使用的数据库编号（当前为1）未被其他服务占用，可尝试切换为其他编号
• 查看Redis的maxclient设置，确保Elastic Beanstalk实例的并发连接数未超出限制

4. 调整Puma服务器配置 #

ActionCable需要独立线程处理WebSocket连接，确保Puma配置有足够线程数，并在worker启动时重新初始化Redis连接：

# config/puma.rb
threads_count = ENV.fetch("RAILS_MAX_THREADS") { 5 }
threads threads_count, threads_count
workers ENV.fetch("WEB_CONCURRENCY") { 2 }
preload_app!

on_worker_boot do
  ActiveRecord::Base.establish_connection
  # 确保worker启动时重新连接Redis
  ActionCable.server.config.redis = { url: "redis://#{ENV.fetch('REDIS_HOST', 'localhost')}:6379/1" }
end

同时在Procfile中明确Puma启动命令：

web: bundle exec puma -C config/puma.rb

5. 延长Classic Load Balancer闲置超时 #

Classic LB默认闲置超时为60秒，会主动断开WebSocket长连接，需调整为更长时间：

1. 进入AWS控制台EC2服务，找到目标Classic负载均衡器
2. 进入「描述」标签，点击「编辑闲置超时」
3. 设置为3600秒（1小时）后保存

6. 开启ActionCable日志定位问题 #

在生产环境开启详细日志，便于排查连接断开的具体原因：

# config/environments/production.rb
config.action_cable.logger = Logger.new(STDOUT)
config.action_cable.log_level = :debug

查看Elastic Beanstalk的/var/log/puma.log或/var/log/nginx/error.log，寻找连接断开时的报错信息。

7. 验证前端Turbo Stream连接逻辑 #

确保前端正确引入ActionCable，并验证订阅逻辑无异常：

# application.html.erb中添加
<%= action_cable_meta_tag %>

检查前端Turbo Stream的频道订阅代码，避免重复订阅或频道名称错误。

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