Ubuntu18升级BigBlueButton2.3后html5客户端报404及Redis连接错误求助

问题根因 #

HTML5客户端、Redlight Rooms等组件依赖Redis服务做会话缓存与状态同步，日志明确给出Redis::CannotConnectError连接被拒报错，Redis连接异常会导致HTML5客户端服务实际未正常启动，即使bbb-conf --status显示所有服务活跃，最终也会返回404错误。

排查修复步骤 #

• 验证Redis服务运行状态
  执行命令：systemctl status redis-server
  若服务显示未运行/启动失败，先执行systemctl start redis-server尝试手动启动，若启动失败继续检查配置文件。
• 校验Redis配置正确性
  打开Redis配置文件/etc/redis/redis.conf，确认如下配置项：
  • bind 127.0.0.1 ::1 确保绑定本地回环地址
  • port 6379 确认端口未被修改
  • protected-mode no 避免本地连接被拦截
    配置修改完成后执行systemctl restart redis-server重启Redis服务。
• 验证Redis本地连通性
  执行命令：redis-cli ping
  正常返回结果为PONG，若仍提示连接被拒，检查本地防火墙规则是否屏蔽了6379端口。
• 同步BBB组件的Redis连接配置
  若Redis本身运行正常，检查BBB各组件的Redis连接参数是否匹配：
  1. 编辑/usr/share/bbb-web/WEB-INF/classes/bigbluebutton.properties，确认redis地址、端口配置与实际一致
  2. 编辑/etc/bigbluebutton/bbb-html5.yml，确认redis连接参数正确
• 重启BBB服务生效
  所有配置调整完成后执行sudo bbb-conf --restart重启全量BBB服务，重启完成后执行sudo bbb-conf --check确认所有服务状态正常，再访问HTML5客户端验证404问题是否解决。

若上述操作后Redis仍启动失败，可执行apt install --reinstall redis-server重装Redis服务，升级过程中配置文件被覆盖是Ubuntu 18系统下的常见诱因。

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