跨设备协同重复拉起同一页面：连接请求如何做幂等、超时和断线重连

跨设备协同重复拉起同一页面连接请求如何做幂等、超时和断线重连手表端“打开手机相机”按钮连续点两次手机出现两个相同页面网络慢时第一次看似超时重试后又多开一次。跨设备拉起涉及两个进程和一段网络单端按钮防抖无法覆盖确认丢失、应用重启和重连。官方跨设备连接能力提供通道应用仍需为一次用户意图定义稳定身份。验证边界本文依据华为开发者官网截至 2026-09-25 可访问的资料整理。文中的状态机、去重器和坐标计算已经在 Node.js 宿主环境执行断言当前本机仍是 API 24 SDK且没有连接 HDC 真机因此不把这些断言写成 API 26 编译或真机实测。涉及窗口、拖拽和跨设备能力的正式交付仍需在 API 26 SDK、模拟器或对应真机上补齐接口编译、交互录像与日志证据。重复执行从哪里来如果每次重试都生成新请求对端无法知道它们其实是同一个动作如果只在内存里记录处理中进程重启后去重表消失。另一个误区是收到连接成功就认为页面已准备实际 UIAbility 可能还在恢复数据。复现需要覆盖连续点击、确认丢失、目标端进程重启和连接中断后恢复。幂等边界怎么定义发送端为一次用户意图生成 requestId在完成、明确失败或租约过期前都复用它。接收端以 requestId 保存 STARTING、READY、FAILED 状态并返回已有结果页面真正可交互后才进入 READY。短期状态持久化使目标进程重启后仍能识别最近请求。type PhaseSTARTING|READY|FAILED; interface Lease { requestId:string; phase:Phase; expiresAt:number; route?:string } export function decide(existing:Lease|undefined, now:number):start|return-existing { if(existing existing.expiresAtnow existing.phase!FAILED) return return-existing; return start; } export function retryId(current:string|undefined){ return current ?? crypto.randomUUID(); }案例一用户连续点击两次第二次请求携带相同 requestId。对端发现状态 STARTING不再创建新页面只返回处理中页面进入 READY 后两次等待都收到同一个 route 和结果。按钮可以显示进度但幂等不能只依赖按钮禁用。案例二目标端已拉起确认在返回途中丢失发送端超时重试同一 requestId目标端从短期存储读到 READY直接返回已存在页面的信息不重复拉起。只有租约过期或明确 FAILED 后用户再次操作才创建新 requestId。失败、重试与回滚观察项容易写错更可靠的处理请求身份每次点击生成新请求同一意图复用 requestId成功标准连接建立就成功页面 READY 才完成去重存储只放内存 Map短期持久化并设置租约超时重试超时立即新开页面查询已有状态再决定requestId 解决“是不是同一次”状态机解决“进行到哪里”租约解决“记录保存多久”。三者组合比简单防抖更适合跨设备因为它能跨网络、跨进程和跨重连保持一致。可复用门禁同一用户意图在重试时复用 requestId。READY 与连接成功严格区分。目标端重启后仍能读取近期请求状态。租约过期与明确失败的规则清楚。连续点击和确认丢失都有自动化断言。官方资料与适用范围跨设备连接 UIAbility 开发指南多设备通用适配指南跨设备重复页面不是按钮点快了这么简单而是一次用户意图没有稳定身份。把幂等做进协议慢网和重连才不会把体验撕成两份。