App 怎么开发聊天功能?2026 指南:路线、接入步骤、成本与上线验收
给 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,只要”能聊” | 商业 SDK | 1–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)
两条硬规则:
- Token 有效期不能超过 24 天,且应显著短于这个上限,配合”即将过期”回调做续期。
- 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 最容易超支的三项
- 推送与存储:离线推送多的产品,存储与带宽增长比 DAU 快。
- 内容审核:文本之外还有图片、语音、视频,按量计费且不可省。
- 合规资质:周期长、需提前启动,拖到上线前会直接阻塞发版。
七、合规:上线前必须过的 5 关
聊天属于 UGC 场景,也是监管重点。以下五项按办理顺序排列:
| # | 事项 | 关键要求 | 大致周期 | 是否阻塞上线 |
|---|---|---|---|---|
| 1 | 主体与资质 | 企业主体(个人开发者通常无法上架社交类应用)、软件著作权 | 1–2 个月 | 是 |
| 2 | ICP 备案 | 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,本地渲染 | 不推荐,消息不入库、无法审核、多端不同步 |
选型时该问厂商的两个问题:
- 是否支持服务端直接发消息(否则 AI 回复只能从客户端伪造)?
- 是否有消息回调/事件通知(否则你无法做旁路审核与 AI 触发)?
判断标准很简单:AI 的回复必须走和真人一样的消息链路——只有这样才能被已读回执、消息漫游、内容审核覆盖。绕过链路的实现,上线后一定返工。
总结
- 列目标端:iOS/Android/Web/小程序/鸿蒙…,缺一个就换方案。
- 列 P0 功能:照第二节的表勾一遍,把 P2 全部划掉。
- 跑通一条消息链路:用免费版,从登录到收到第一条消息,半天足够。
聊天功能的技术门槛不在”发一条消息”,而在”发一千万条消息之后仍然正确”。先把验收标准定下来,再决定谁来写这段代码。
更多推荐
所有评论(0)