企业官网建设流程全解析

QUIC 长连接收到重复推送怎么办：连接世代、messageId 与幂等消费

手机从 Wi-Fi 切到蜂窝网络后，通知列表突然多出两条相同消息；日志里还能看到旧连接在新连接建立后晚到一步。QUIC 能减少握手和队头阻塞，但不会替应用决定“哪条连接仍有效”和“重复业务消息能不能再次执行”。这两个边界必须由调用方自己守住。

验证范围：本文依据华为开发者官网截至 2026-09-22 的公开资料整理。当前本机 DevEco SDK 为 API 24，且没有连接 HDC 真机；涉及 API 26 的接口片段用于说明接入与排障边界，不宣称已经完成 API 26 编译或真机验证。文中的时间戳校验、状态机、坐标换算、去重合并与资源预算逻辑已通过 Node.js 宿主测试，正式上线仍需在 API 26 SDK 和目标设备上补齐编译、权限、异常分支与性能验收。

先把误判停下来

把“连接成功”当作永久状态，或者认为 QUIC 传输可靠就绝不会收到重复业务消息，都会把协议能力和业务语义混在一起。网络切换、进程恢复、服务端超时重试都可能形成新连接或重复推送；应用应分别用连接世代隔离旧回调，用 messageId 保证消费幂等。

interfaceConnectionGate{generation:number;state:'idle'|'connecting'|'ready'}functionbeginReconnect(gate:ConnectionGate):number{gate.generation+=1;gate.state='connecting';returngate.generation;}functionacceptCallback(gate:ConnectionGate,callbackGeneration:number):boolean{returngate.generation===callbackGeneration;}

案例一：网络切换后旧连接回调晚到

每次建连先递增 generation，并把这个值绑定到连接及其所有回调。回调触发时先比较当前 generation，不一致就只释放旧资源，不更新页面、不安排重连。这样能阻止旧连接的 close 事件把新连接重新打回 connecting。

案例二：服务端重试导致同一任务执行两次

连接层收到消息后不要直接写数据库或触发通知。先校验 messageId，在有界缓存或持久化消费表中做原子占位；已存在则确认接收但跳过副作用。缓存要有容量和过期策略，关键交易类消息还应由服务端提供可查询的最终状态。

classMessageDedupe{privateseen=newMap<string,number>();accept(id:string,now:number,ttlMs=300000):boolean{for(const[key,time]ofthis.seen)if(now-time>ttlMs)this.seen.delete(key);if(this.seen.has(id))returnfalse;this.seen.set(id,now);returntrue;}}

证据怎么对齐

为什么采用这条路径

连接世代解决“谁还能说话”，messageId 解决“这件事做过没有”，两者不能互相替代。普通资讯可以用有界内存缓存，订单、协作指令等有副作用的消息应落持久化消费表，并给失败重试留下明确终态。

上线前复核

• 每次建连生成独立世代号并贯穿所有回调。
• 重连使用指数退避和随机抖动，避免惊群。
• 消息先去重再更新状态、数据库或通知。
• 旧连接只释放资源，不反向覆盖新连接状态。
• 覆盖 Wi-Fi/蜂窝切换、服务端重试和进程恢复。

官方资料

• QUIC 长连接接收消息推送
• HarmonyOS 7 网络新能力课程
• HarmonyOS 26.0.0 版本说明

长连接稳定不等于业务只执行一次。把连接身份和消息身份分开管理，网络切换与服务端重试才不会变成用户眼里的重复操作。