Rocket.Chat推送通知"Unsupported Version"错误分析与解决方案

问题背景

在使用Rocket.Chat自托管社区版(Docker部署)时，用户遇到了推送通知无法正常工作的问题。系统日志中反复出现"Error sending push to gateway"和"unsupported version"的错误信息，尽管Rocket.Chat云控制台显示一切正常。

环境信息

• Rocket.Chat版本：7.1.0
• 应用引擎版本：1.48.0
• Node.js版本：v20.17.0
• MongoDB版本：6.0.13
• 部署方式：Docker容器

错误现象

系统日志中持续记录以下错误：

Error sending push to gateway (5 try) -> {"errorMsg":"unsupported version"}

同时，还观察到与Rocket.Chat云服务通信失败的日志：

Failed to communicate with Rocket.Chat Cloud

根本原因分析

经过深入排查，发现问题的根源在于Docker容器内部的SSL/TLS证书过期和库版本过旧。具体表现为：

1. 容器内无法正确验证Rocket.Chat云服务的SSL证书
2. 与推送网关的HTTPS连接因证书问题被拒绝
3. 系统错误地将连接问题解释为"版本不支持"

解决方案

步骤一：更新容器内系统组件

进入Rocket.Chat容器并执行以下命令：

docker exec -it <容器名称> /bin/sh
apk update
apk upgrade
apk add --no-cache openssl ca-certificates
update-ca-certificates

步骤二：验证修复效果

执行以下命令测试连接是否正常：

wget -q -O - https://releases.rocket.chat/v2/server/supportedVersions

步骤三：检查云控制台配置

确保云控制台中显示的是正确的公开域名而非内部IP地址。

遗留问题

修复后仍会偶尔出现"AbortError"错误，但经测试确认这不会影响系统功能。该错误可能是由于请求超时机制导致的，属于正常现象。

最佳实践建议

1. 定期更新Docker基础镜像以保持系统组件最新
2. 为自托管实例配置有效的SSL证书
3. 确保容器能够访问外部网络资源
4. 监控推送通知配额使用情况(社区版限制为每月10,000条)

总结

Rocket.Chat推送通知问题通常与网络连接和证书验证相关。通过更新容器内系统组件和证书，可以有效解决"unsupported version"错误。对于自托管部署，建议建立定期维护机制以确保系统组件保持最新状态。