给 App 加聊天功能,常规路线是:自研长连接、开源自建、接入商业 IM SDK。如果聊天不是你的核心业务,不考虑从零写长连接。

真正的难点从来不是”把消息发出去”,而是消息不丢不重、多端一致、离线能触达、内容能过审、成本不失控。下面按”选路线 → 定功能 → 接入 → 算钱 → 过审 → 验收”的顺序讲完。

一、开发聊天功能常见路线

先把”聊天功能”拆开看。它不是一个页面,而是六层能力叠起来的系统:

层组成自研要做的事
连接层长连接网关、心跳保活、断线重连连接路由、集群扩容、百万连接压测
消息层收发、序号、去重、撤回、已读会话内 Seq、幂等、ACK 与重试
存储层消息库、会话库、离线队列分库分表、冷热分离、漫游查询
同步层多端同步、增量拉取游标管理、跨端一致性
触达层APNs、华为/小米/OPPO/vivo/FCM各厂商通道适配、角标、免打扰
治理层敏感词、内容审核、举报、封禁审核链路、人工复核后台

任何一条路线,这六层都得有人负责。区别只是”你写”还是”厂商写”。

1.1 完全自研长连接

适合:IM 是产品核心竞争力(社交、通讯工具)、有专职 IM 团队、数据必须完全自主。

代价​:3–6 个月起步,且上线只是开始。长连接是有状态服务,扩容、灰度、故障恢复都比无状态服务难一个量级。多数团队低估的不是开发量,是弱网测试和线上排障的长期投入。

1.2 开源自建

适合:需要私有化、又不想从协议写起。

省下的:协议设计、基础消息模型、部分客户端 SDK。 没省下的:部署、压测、监控、版本升级、安全加固、故障处理。开源不等于免费,它把”license 费用”换成了”人的时间”。

1.3 商业 IM SDK

适合:绝大多数业务型 App。

拿到的:长连接、消息投递、多端同步、离线推送、消息存储、群组管理,通常还配 UI Kit。 代价:按 DAU 计费;能力按版本分档(已读回执、在线状态这类功能常在高版本);部分数据在厂商侧。

1.4 决策表

你的情况推荐路线理由
IM 是核心业务,日活预期百万级自研或深度定制长期成本与差异化
政企/金融/医疗,数据不能出内网开源私有化 或 商业私有化合规优先,但先核对是否真离线
业务型 App,只要”能聊”商业 SDK1–2 周上线,把预算留给业务
独立开发者 / MVP 验证商业 SDK 免费版先跑通一条消息链路再说
已有音视频,要加文字聊天与 RTC 同厂商的 IM同一会话 ID 打通,少一层集成

二、聊天功能包含什么:P0/P1/P2 清单

下面这张表按上线必要性分级:

模块能力优先级不做的后果
消息文本、表情、图片P0功能不成立
消息语音、文件、视频、自定义消息P1场景受限(客服、协作类必备)
会话会话列表、未读数、最后一条消息P0用户找不到对话
会话置顶、免打扰、草稿P1体验粗糙但不阻塞
关系单聊发起、用户资料P0无法建立对话
群组建群、拉人、退群、群主/管理员P1社交与协作场景缺失
群组禁言、踢人、@提醒、群公告P2规模化运营才需要
状态已送达、已读回执P1客服/协作场景不可用
状态正在输入、在线状态P2增值体验
触达离线推送、角标P0用户离开 App 就失联
存储消息漫游、本地缓存、搜索P1换设备即丢历史
治理敏感词、内容审核、举报P0上不了架(见第八节)
后台会话查询、消息撤回、封禁P1出问题无法处置

判断标准:P0 缺一个就不能上线;P1 决定产品好不好用;P2 决定能不能规模化运营。第一版别做 P2,把省下的时间投到验收上。

三、选型要看的 4 个硬约束

不要按厂商列功能表对比,那会得到”全都支持”的结论。按约束淘汰更快:

约束要确认的问题一票否决情形
端覆盖目标端是否全覆盖:iOS/Android/Web/小程序/鸿蒙/Flutter/桌面你的主端不在支持列表
数据与合规能否私有化?授权校验、推送、升级是否仍依赖公网?内网环境但校验要连外网
成本模型按峰值 DAU 还是 MAU?功能是否分版本?超额怎么算?已读回执在你不接受的档位
音视频协同能否与 RTC 共用同一个会话/房间 ID要两套账号体系打通

以 ZEGO ZIM 为例说明”端覆盖”这项怎么查:其 SDK 覆盖 Android、iOS、Web、Flutter、React Native、小程序、鸿蒙、Windows、macOS、Unity 等端;离线推送由独立推送组件配合各厂商通道完成。这类信息必须去厂商文档的”平台支持”页逐项核对。

关键提醒:私有化方案要专门验证三件事,授权是否离线校验、推送是否走厂商公网通道、版本升级是否需要外网。很多”支持私有化”的产品在这三点上仍依赖公网。

四、SDK 接入步骤示例

不同 SDK 的接口名字不同,流程骨架一致,这里以 ZEGO ZIM 为例走一遍。每一步都给出验收点,做完一步验一步,比最后联调省时间。

Step 1:控制台建项目,开通服务

拿到 AppID 与 ServerSecret(或 AppSign)。注意:ZIM 服务不是默认开启的,需要在控制台自助开通”即时通讯”服务。

验收点:能拿到 AppID;服务状态显示已开通。

Step 2:服务端生成 Token

正确链路是:客户端向你的服务端申请 → 服务端用 ServerSecret 生成 Token → 客户端带 userID + Token 登录 → SDK 自动向 ZIM 服务端校验。

const appId uint32 = <Your AppId>
userId := <Your userID>
secret := <ServerSecret>
const effectiveTimeInSeconds int64 = <Your token effectiveTime> // 单位:秒

token, err := zsa.GenerateToken04(appId, userId, secret, effectiveTimeInSeconds)
if err != nil {
    fmt.Println(err)
    return
}
fmt.Println(token)

两条硬规则:

  1. Token 有效期不能超过 24 天,且应显著短于这个上限,配合”即将过期”回调做续期。
  2. ServerSecret 绝不能出现在客户端。前端生成 Token 只用于本地调试,上线必须走服务端。

验收点:抓包确认客户端拿不到 ServerSecret;Token 过期后能触发重新申请并自动重登。

Step 3:集成 SDK

按端选包。移动端注意混淆规则与权限声明;Web 端注意打包体积;小程序端注意域名白名单。

验收点:空工程能初始化成功,不报依赖冲突。

Step 4:初始化并登录

初始化一次,登录按用户会话多次。登录成功后立刻做一件事:拉取离线期间的消息,否则用户会看到”消息缺失”。

验收点:冷启动 → 登录 → 能收到登录前别人发的消息。

Step 5:会话与消息收发

单聊、群聊、房间消息是三种不同模型:单聊按用户寻址,群聊按群组寻址,房间消息适合直播/语聊这类”进房才收”的场景,通常不做离线存储。

发消息时把推送配置一起带上,离线用户才能被触达:

ZIMTextMessage textMessage = new ZIMTextMessage();
ZIMPushConfig pushConfig = new ZIMPushConfig();
pushConfig.title = "离线推送标题";
pushConfig.content = "离线推送内容";
pushConfig.payload = "自定义透传字段,非必填";
pushConfig.resourcesID = "资源 ID,非必填";

ZIMMessageSendConfig sentConfig = new ZIMMessageSendConfig();
sentConfig.pushConfig = pushConfig;

zim.sendMessage(textMessage, "myUserID", ZIMConversationType.PEER, sentConfig, new ZIMMessageSentCallback() {
    @Override
    public void onMessageSent(ZIMMessage message, ZIMError errorInfo) { }

    @Override
    public void onMessageAttached(ZIMMessage message) { }
});

注意:房间消息通常不支持设置离线推送配置,需要单独申请权限。

验收点:飞行模式下发送 → 恢复网络 → 消息不重复、不乱序、不丢。

Step 6:配置离线推送

在控制台配置各厂商推送证书,客户端集成推送组件并注册。要逐个验证的通道:APNs、华为、荣耀、小米、OPPO、vivo、FCM。

验收点:杀进程后仍能收到推送;点击推送能跳到正确会话;角标数与未读数一致。

Step 7:压测与监控接入

上线前至少跑一轮:万条消息滚动、大群并发、弱网切换。上线后接入厂商的质量监控或自建埋点。

验收点:有消息送达率、推送到达率、登录成功率的监控曲线。

五、哪些自己写,哪些交给 SDK

这是最容易被忽略、也最影响长期成本的一节。

能力放在哪原因
账号体系、登录态自有后端换供应商时不用迁移用户
好友/关系链/黑名单自有后端属于业务数据,不属于通信能力
权限与角色自有后端审核与运营规则天天变
业务消息(订单、系统通知)自有后端需要与业务事务一致
审核策略与处置自有后端 + 审核服务策略是核心竞争力
数据归档与分析自有数仓厂商只保证通信,不保证分析
长连接与投递SDK自研性价比最低的部分
多端同步、离线推送SDK厂商通道适配成本极高
消息存储与漫游SDK(或自建)按合规要求决定

工程建议:在业务代码与 SDK 之间加一层 IM Adapter,把”登录、发消息、拉历史、收回调”收敛成 4–6 个方法。这样换供应商时只改一层,不改业务。

六、成本与周期:把报价拆开算

网上”做个聊天功能多少钱”的答案从 5 万到百万都有,因为大家算的不是同一件事。

6.1 自研 TCO

项目量级说明
人力6 人 × 6 个月 ≈ 45–90 万后端 2、客户端 2、测试 1、运维 1
服务器与带宽1–3 万/月(1 万 DAU,纯文本)含长连接网关、MQ、存储
合规资质数万至十几万备案、等保测评、许可
年运维初期开发成本的 15%–25%最容易漏算的一项

6.2 SDK 计费口径

主流厂商按峰值 DAU 月结,套餐包含一定免费 DAU,超出部分按”每万 DAU”后付费,且不足 1 万按 1 万计。公开报价大致区间(以各厂商官网为准):

厂商入门付费档高阶档免费额度
腾讯云 IM专业版约 1,499 元/月旗舰版约 3,999 元/月体验版 100 用户
环信专业版约 1,299 元/月旗舰版约 2,999 元/月免费版 100 DAU
网易云信标准版约 899 元(日活5000)旗舰版约 3,999 元免费试用版
ZEGO ZIM专业版约 999 元/月旗舰版约 2,999 元/月免费版 100 DAU

注意:各厂商 SDK 计费口径截至2026年11月16日。

6.3 三档规模对照

规模建议大致月成本
≤1 万 DAU商业 SDK 入门档千元级
1–10 万 DAU商业 SDK 中档 + 自建业务后端数千至 2 万元
≥10 万 DAU 且 IM 是核心评估自研或私有化需按 TCO 单独测算

6.4 最容易超支的三项

  1. 推送与存储:离线推送多的产品,存储与带宽增长比 DAU 快。
  2. 内容审核:文本之外还有图片、语音、视频,按量计费且不可省。
  3. 合规资质:周期长、需提前启动,拖到上线前会直接阻塞发版。

七、合规:上线前必须过的 5 关

聊天属于 UGC 场景,也是监管重点。以下五项按办理顺序排列:

#事项关键要求大致周期是否阻塞上线
1主体与资质企业主体(个人开发者通常无法上架社交类应用)、软件著作权1–2 个月是
2ICP 备案App 备案为强制项2–4 周是
3安全评估报告具有舆论属性或社会动员能力的服务需自评估并提交2–6 周是
4等保备案与测评一般二级起步,涉及敏感数据可能三级1–3 个月是
5实名 + 内容审核即时通讯属强制实名场景;需机器审核 + 人工复核机制持续是

补充三项常被漏掉的:

  • 公安联网备案:开通服务后按规定期限办理,App 内需展示备案编号。
  • 日志与记录留存:按《网络安全法》及平台审核要求留存,通常 6 个月起,具体以主管部门要求为准。
  • 未成年人保护:青少年模式、时段限制,陌生人社交类审核更严。

排期建议:把合规当成一个 1–3 个月的并行阶段,与开发同时启动,而不是上线前两周才想起来。

八、上线验收清单:怎么证明”做完了”

这份清单可以直接抄进测试用例。

功能验收

  • [ ] 单聊/群聊/房间消息三端互通
  • [ ] 文本、图片、语音、文件、自定义消息发送与展示
  • [ ] 撤回、已读回执、@提醒、消息搜索
  • [ ] 会话列表未读数与实际一致

异常验收

  • [ ] 断网发送 → 恢复后补发成功且不重复
  • [ ] 弱网(丢包 30%、延迟 500ms)下消息可达
  • [ ] 杀进程后重进,本地消息不丢
  • [ ] Wi-Fi ↔ 4G 切换,30 秒内恢复连接
  • [ ] 同一账号两端同时在线,消息双端一致

一致性验收

  • [ ] 消息不丢、不重、不乱序(构造乱序到达场景验证)
  • [ ] 多端已读状态同步,红点不残留
  • [ ] 换设备登录,历史消息与本地一致

触达验收

  • [ ] 各厂商通道推送均能到达(APNs/华为/荣耀/小米/OPPO/vivo/FCM)
  • [ ] 点击推送进入正确会话
  • [ ] 角标数与未读数一致,清除后归零
  • [ ] 免打扰会话不弹通知但仍有未读

性能验收

  • [ ] 会话列表首屏加载 < 500ms
  • [ ] 万条消息滚动不卡顿
  • [ ] 大群(按你的上限)并发发送不雪崩

运维验收

  • [ ] 有登录成功率、消息送达率、推送到达率监控
  • [ ] 有告警阈值与值班响应
  • [ ] 消息可追溯(能按用户/会话查历史)

九、四个场景的差异化建议

场景技术重心最容易做错的地方
电商/工具类客服IM + 会话分配 + 工单把客服当社交做,忽略排队与转接
社交/社区关系链 + 内容审核 + 冷启动审核上线才补,导致无法过审
在线教育/医疗IM 信令 + RTC 媒体 + 录制两套账号体系,通话与聊天对不上
游戏/出海端覆盖 + 全球节点 + 弱网只测了国内网络

十、AI 时代的新变量:聊天功能 + Agent

2026 年加聊天功能,大概率同时要接 AI 客服或 AI 助手。三种接法差别很大:

接法做法评价
机器人账号注册一个特殊 userID,作为对端发消息推荐,天然复用已读、漫游、审核
服务端旁路消息回调 → 调 LLM → 以机器人身份回写推荐,逻辑可控、可审计
客户端直连大模型App 直接调模型 API,本地渲染不推荐,消息不入库、无法审核、多端不同步

选型时该问厂商的两个问题:

  1. 是否支持服务端直接发消息(否则 AI 回复只能从客户端伪造)?
  2. 是否有消息回调/事件通知(否则你无法做旁路审核与 AI 触发)?

判断标准很简单:AI 的回复必须走和真人一样的消息链路——只有这样才能被已读回执、消息漫游、内容审核覆盖。绕过链路的实现,上线后一定返工。

总结

  1. 列目标端:iOS/Android/Web/小程序/鸿蒙…,缺一个就换方案。
  2. 列 P0 功能:照第二节的表勾一遍,把 P2 全部划掉。
  3. 跑通一条消息链路:用免费版,从登录到收到第一条消息,半天足够。

聊天功能的技术门槛不在”发一条消息”,而在”发一千万条消息之后仍然正确”。先把验收标准定下来,再决定谁来写这段代码。

Logo

开源鸿蒙跨平台开发社区汇聚开发者与厂商,共建“一次开发,多端部署”的开源生态,致力于降低跨端开发门槛,推动万物智联创新。

更多推荐