TapCub 正式上线:统计、分析、客服一个平台免费用
在线客服

Flutter 实时聊天:基于 WebSocket 自建,还是嵌入 SDK

怎么给 Flutter 应用加实时聊天:WebSocket 教程漏掉了什么、重连的计算、自建对嵌入的工作量估算和决策规则。

艾玛·柯林斯 发布于 2026 年 11 月 21 日 8 分钟阅读 在线客服
示例数据:规划估算自建 58 人天,嵌入 8 人天。按每天 400 计,是 23,200 对 3,200,还没算运行成本。示例数据

给 Flutter 应用加实时聊天,要么基于 WebSocket 自建,要么嵌入聊天 SDK。Flutter 自己的教程大约十五行,但没有重连、推送和离线队列。在所述假设下,自建要 58 人天,嵌入只要 8 人天,回本要约 14.7 年,所以只有聊天就是你的产品时才自建。

读完你会知道

  • 教程里的 WebSocket 示例只打开一次通道,没有重连逻辑
  • Android 的 Doze 会暂停网络访问,所以应用空闲时的消息靠推送(FCM)
  • 示例估算:自建 58 人天对嵌入 8 人天;回本约 14.7 年

给 Flutter 应用加实时聊天的两种办法

Flutter 里的实时聊天,指一台设备上输入的消息,一两秒内出现在另一台设备上。有两种办法。自建:自己运行 WebSocket 服务器,自己写 Flutter 客户端、存储、重连和通知的代码。嵌入:用已经做好这些事的聊天 SDK 或托管组件,把时间花在它在应用里的样子上。第三条路,从按钮打开网页聊天页,在应用内实时客服里讲;更宽的「SDK 对比组件」选择看聊天 SDK 与组件。本文帮你用数字在前两种之间做决定,并明确说明 TapCub 在 Flutter 应用里能做什么、不能做什么。

Flutter 的 WebSocket 示例给了什么,漏了什么

Flutter 文档用 web_socket_channel 包展示聊天的基本循环:用 WebSocketChannel.connect(Uri.parse('wss://…')) 连接,从 channel.stream 读消息(教程用 StreamBuilder 在每个事件时重建界面),用 channel.sink.add(...) 发送,在 dispose() 里用 channel.sink.close() 关闭。大约十五行代码,在网络良好时能用。

按它自己的示例,教程没有覆盖的是:通道只打开一次,没有重试,也不处理连接断开。下面所有内容,都是把这个演示变成聊天要补上的代码。

你必须自己做的部分

部分要做什么容易出错的地方
身份验证在接收消息前证明连接的是谁令牌在对话中途过期
重连断开后用退避策略重新打开套接字所有客户端在同一秒重连
消息 ID 与顺序给每条消息一个独有的 ID,重试时不会重复消息重复或乱序
离线队列保存未发送的消息,重连后发送应用被杀掉时消息丢失
本地存储打开时立刻显示历史打开慢、历史过期
推送通知应用关闭时通知用户有消息消息只在应用打开时才到
送达与已读状态标记已发送、已送达、已读重连后状态错误
坐席端员工回复、分配、搜索的收件箱往往比应用本身的工作量还大
附件、审核上传文件、拦截滥用安全和存储成本

前七项是客户端和服务器的管道工作。第八项坐席收件箱,是团队最容易忘记预算的部分。

为什么 Flutter 应用不能一直开着套接字

在 Android 上,Google 的文档说,设备不插电、静止、屏幕关闭一段时间后,Doze 模式会暂停应用的网络访问,并推迟任务、同步和标准闹钟;系统会开启短暂的维护窗口,而且随着时间推移越来越少。Google 建议需要在设备空闲时收消息的应用使用 Firebase Cloud Messaging,因为 FCM 共用一个持久连接,可以用 RemoteNotification 消息唤醒应用。同一页还把聊天应用列为应该使用 FCM,而不是让用户把应用从电池优化中排除的类型,除非出于技术原因无法使用 FCM。

实际的结论:你的 WebSocket 负责应用打开时的对话,推送负责其余所有情况。跳过推送的自建聊天在测试时看起来没问题,实际使用时会失败,因为手机会休眠。

重连逻辑,带数字

手机上的网络总在掉:电梯、隧道、从 Wi-Fi 切到移动数据。用带抖动的指数退避:等待 基数 × 2^次数 秒,设上限,并在这段等待内随机选一个时间。

示例数据:基数 1 秒、上限 30 秒,第 1 到 7 次的等待是 1、2、4、8、16、30、30 秒,前六次合计 61 秒。

为什么要加抖动:假设服务器重启,10,000 个已连接的应用同时断开。没有抖动,它们会在同样的时刻重试,第一次重试时 10,000 个连接在同一秒涌来。把第四次 8 秒的等待用随机延迟铺开,平均负载是 10,000 ÷ 8 = 1,250 个连接每秒。这就是服务器恢复和服务器再次垮掉的区别。

Duration retryDelay(int attempt) {
  final capSeconds = 30;
  final waitSeconds = min(capSeconds, pow(2, attempt).toInt());
  return Duration(milliseconds: Random().nextInt(waitSeconds * 1000));
}

还要保持连接:WebSocket 协议(RFC 6455)定义了 ping 和 pong 控制帧(操作码 0x9 和 0xA),很多服务器和代理会丢弃空闲连接,所以按计时器发 ping,没收到 pong 就重连。

工作量和成本:自建对嵌入

这些是带明确假设的规划估算,不是实测。示例数据,单位是人天,团队为已有应用加聊天:

组件自建嵌入
套接字服务器和身份验证101
客户端界面(列表、输入、滚动、图片)83
重连和离线队列60
推送通知集成52
坐席收件箱和后台150
附件、审核、搜索80
跨设备和网络测试62
合计588

假设每人天 400:自建是 58 × 400 = 23,200,嵌入是 8 × 400 = 3,200,差 50 人天,即 20,000。再加运行成本:每年维护按自建工作量的 20% 算,是 58 × 0.2 = 11.6 人天,约 4,640 每年;嵌入方案假设订阅费每月 500,即每年 6,000。自建每年省 6,000 − 4,640 = 1,360,所以多花的 20,000 要 20,000 ÷ 1,360 ≈ 14.7 年才回本,还没算服务器成本。按你团队的情况改假设:只有当聊天是你会持续扩展的核心功能,或者供应商价格随用量增长时,结论才会反过来。

app.tapcub.com

加实时聊天的工作量

示例估算,人天
基于 WebSocket 自建58
嵌入 SDK8
示例数据
示例数据:规划估算自建 58 人天,嵌入 8 人天。按每天 400 计,是 23,200 对 3,200,还没算运行成本。
组件自建(人天)嵌入(人天)
套接字服务器和身份验证101
客户端界面83
重连和离线队列60
推送集成52
坐席收件箱和后台150
附件、审核、搜索80
测试62
合计588

带明确假设的规划估算,不是实测。

上线前先测聊天:六个用例清单

不管选哪种方案,上线前都要在真实的 Android 手机和真实的 iPhone 上跑这些用例,每个都有明确的通过条件:

用例怎么做什么算通过
发消息途中开飞行模式输入消息,切到飞行模式,发送,再切回来消息在重连后发出一次,不是两次,也不是丢失
杀掉应用发一条消息,划掉应用,重新打开历史还在;未发出的消息没有丢
后台 15 分钟关屏离开应用,从另一台设备回复收到推送通知;点开后看到消息
切换网络聊天打开时从 Wi-Fi 切到移动数据套接字在退避窗口内重连
连点发送快速点两下发送只有一条消息,靠消息 ID 去重
长历史打开有 500 多条消息的对话一秒内打开,滚动流畅

在 Android 上,可以用 Google 文档里的 adb 命令 adb shell dumpsys deviceidle force-idle 强制设备进入空闲模式,观察消息是否仍然到达。某个用例失败时,先修好再加功能。把每个用例的结果连同应用版本和设备型号记在一张小表里,这样每次涉及网络、推送或聊天页的发布之后都能重跑一遍(新同事也能看到已经覆盖了什么)。重跑同样的六个用例,比调试一个无法复现的现场反馈便宜。

怎么决定

按这些规则:

  1. 聊天就是产品(聊天功能是你竞争力的即时通讯或交易平台应用):自建,并且从第一天就给坐席或审核端留预算。
  2. 聊天是应用里的支持或销售渠道,应用本身做别的事:嵌入,把省下来的几周花在产品上。
  3. 数据必须留在你自己的地区或数据库里:自建,或选一个把数据存在你需要的地方的供应商。
  4. 移动端工程师少于两人:嵌入;光推送和重连的工作就可能要一个月。
  5. 拿不准:先嵌入,衡量有多少用户打开聊天,等数字够了再重新考虑。

在 TapCub 里怎么做

TapCub 不提供 Flutter 聊天组件,所以它不是应用内聊天的「嵌入」选项。它对 Flutter 应用做的是衡量:

  1. 添加插件。 flutter pub add tapcub_flutter,然后用站点密钥和应用 ID 调用 TapCub.preInit(...) 和 TapCub.init()。0.2.0 版需要 Flutter 3.44 和 Dart 3.12 或更新版本。
  2. 记录页面和聊天事件。 在 MaterialApp 上挂 TapCub.navigatorObserver(只对有名字的路由生效),并在聊天页里调用 TapCub.track('chat_opened') 和 TapCub.track('chat_message_sent'),不管你选的是哪种聊天方案。
  3. 用数据比较方案。 在全端分析 › 行为分析 › 行为分析里搭一个从打开应用到打开聊天再到发出消息的漏斗,并在应用统计 › 用户分析 › 版本分布里按应用版本看同样的聊天事件。
  4. 识别用户。 调用 TapCub.login('USER_ID'),让同一个人跨设备被识别。
  5. 网站聊天。 如果你的网站也需要支持聊天,TapCub 的聊天是一个和统计共用同一段脚本加载的网页组件,见客服 › 聊天设置 › 安装。

TapCub 衡量聊天前后发生了什么,不在你的 Flutter 应用里运行聊天的传输层。

FAQ

怎么在 Flutter 里做实时聊天?

用 web_socket_channel 包连接 WebSocket 服务器,从 channel.stream 读,用 channel.sink.add 发。然后补上基础示例省略的部分:身份验证、带退避的重连、消息 ID、离线队列和推送通知。

应用在后台时 WebSocket 聊天还能用吗?

不可靠。在 Android 上,设备空闲时 Doze 会暂停网络访问,所以 Google 建议对空闲设备的消息投递使用 Firebase Cloud Messaging。

在 Flutter 里该自建聊天还是用 SDK?

只有聊天是产品核心时才自建。示例里自建要 58 人天,嵌入要 8 人天,在所述假设下回本要约 14.7 年。

在 Flutter 里怎么重连 WebSocket?

监听流的错误和完成事件,用指数退避加随机抖动等待,然后创建新的通道。教程里没有这部分。

能在 Flutter 应用里用 TapCub 的聊天吗?

TapCub 的聊天是网页组件。它的 Flutter 插件衡量页面、事件和用户,不提供应用内聊天组件。

资料来源

归档:在线客服

这篇文章对你有帮助吗?

我们会根据反馈修改和补充这篇内容。

艾玛·柯林斯

产品分析师

聚焦事件分析、转化漏斗与用户留存,用清晰的指标定义和分析框架解释产品表现。

衡量应用内聊天的效果

Flutter 应用的页面、事件和漏斗,都在同一个项目里。

看清数据,找到增长。

每一次点击,都有数据依据。装好一行代码,1 分钟看到第一批数据。

无需信用卡 · 统计与客服都有免费版 · 统计无 Cookie