给 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 就重连。
工作量和成本:自建对嵌入
这些是带明确假设的规划估算,不是实测。示例数据,单位是人天,团队为已有应用加聊天:
| 组件 | 自建 | 嵌入 |
|---|---|---|
| 套接字服务器和身份验证 | 10 | 1 |
| 客户端界面(列表、输入、滚动、图片) | 8 | 3 |
| 重连和离线队列 | 6 | 0 |
| 推送通知集成 | 5 | 2 |
| 坐席收件箱和后台 | 15 | 0 |
| 附件、审核、搜索 | 8 | 0 |
| 跨设备和网络测试 | 6 | 2 |
| 合计 | 58 | 8 |
假设每人天 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 年才回本,还没算服务器成本。按你团队的情况改假设:只有当聊天是你会持续扩展的核心功能,或者供应商价格随用量增长时,结论才会反过来。
加实时聊天的工作量
示例估算,人天| 组件 | 自建(人天) | 嵌入(人天) |
|---|---|---|
| 套接字服务器和身份验证 | 10 | 1 |
| 客户端界面 | 8 | 3 |
| 重连和离线队列 | 6 | 0 |
| 推送集成 | 5 | 2 |
| 坐席收件箱和后台 | 15 | 0 |
| 附件、审核、搜索 | 8 | 0 |
| 测试 | 6 | 2 |
| 合计 | 58 | 8 |
带明确假设的规划估算,不是实测。
上线前先测聊天:六个用例清单
不管选哪种方案,上线前都要在真实的 Android 手机和真实的 iPhone 上跑这些用例,每个都有明确的通过条件:
| 用例 | 怎么做 | 什么算通过 |
|---|---|---|
| 发消息途中开飞行模式 | 输入消息,切到飞行模式,发送,再切回来 | 消息在重连后发出一次,不是两次,也不是丢失 |
| 杀掉应用 | 发一条消息,划掉应用,重新打开 | 历史还在;未发出的消息没有丢 |
| 后台 15 分钟 | 关屏离开应用,从另一台设备回复 | 收到推送通知;点开后看到消息 |
| 切换网络 | 聊天打开时从 Wi-Fi 切到移动数据 | 套接字在退避窗口内重连 |
| 连点发送 | 快速点两下发送 | 只有一条消息,靠消息 ID 去重 |
| 长历史 | 打开有 500 多条消息的对话 | 一秒内打开,滚动流畅 |
在 Android 上,可以用 Google 文档里的 adb 命令 adb shell dumpsys deviceidle force-idle 强制设备进入空闲模式,观察消息是否仍然到达。某个用例失败时,先修好再加功能。把每个用例的结果连同应用版本和设备型号记在一张小表里,这样每次涉及网络、推送或聊天页的发布之后都能重跑一遍(新同事也能看到已经覆盖了什么)。重跑同样的六个用例,比调试一个无法复现的现场反馈便宜。
怎么决定
按这些规则:
- 聊天就是产品(聊天功能是你竞争力的即时通讯或交易平台应用):自建,并且从第一天就给坐席或审核端留预算。
- 聊天是应用里的支持或销售渠道,应用本身做别的事:嵌入,把省下来的几周花在产品上。
- 数据必须留在你自己的地区或数据库里:自建,或选一个把数据存在你需要的地方的供应商。
- 移动端工程师少于两人:嵌入;光推送和重连的工作就可能要一个月。
- 拿不准:先嵌入,衡量有多少用户打开聊天,等数字够了再重新考虑。
在 TapCub 里怎么做
TapCub 不提供 Flutter 聊天组件,所以它不是应用内聊天的「嵌入」选项。它对 Flutter 应用做的是衡量:
- 添加插件。
flutter pub add tapcub_flutter,然后用站点密钥和应用 ID 调用TapCub.preInit(...)和TapCub.init()。0.2.0 版需要 Flutter 3.44 和 Dart 3.12 或更新版本。 - 记录页面和聊天事件。 在
MaterialApp上挂TapCub.navigatorObserver(只对有名字的路由生效),并在聊天页里调用TapCub.track('chat_opened')和TapCub.track('chat_message_sent'),不管你选的是哪种聊天方案。 - 用数据比较方案。 在全端分析 › 行为分析 › 行为分析里搭一个从打开应用到打开聊天再到发出消息的漏斗,并在应用统计 › 用户分析 › 版本分布里按应用版本看同样的聊天事件。
- 识别用户。 调用
TapCub.login('USER_ID'),让同一个人跨设备被识别。 - 网站聊天。 如果你的网站也需要支持聊天,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 文档,Work with WebSockets。
- Android Developers,Optimize for Doze and App Standby。
- IETF,RFC 6455: The WebSocket Protocol,第 5.2 节(ping 与 pong 操作码)。
这篇文章对你有帮助吗?
我们会根据反馈修改和补充这篇内容。
提交没有成功,请稍后再试。
谢谢你的反馈,我们会据此改进这篇内容。你已经反馈过这篇了,谢谢。

