弹窗关了页面也跟着退HarmonyOS 7 OverlayManager onBackPress 返回链怎么收口在菜谱详情页打开“筛选条件”弹层后按返回键弹层先消失页面随后也退出日志里同一次操作出现 overlay.close 与 router.back 两条记录。问题不是动画慢而是弹层和页面同时消费了返回链。本文交付一个可复用的 OverlayBackRouter、嵌套弹层栈规则、6 组状态测试以及接入页面的文件级检查表。。图中的每条箭头都应对应一条可查询日志输入、平台调用、状态映射、UI 或降级结果。只有 UI 变化而没有中间证据后续仍然难以区分接口失败和页面逻辑错误。官方依据与版本边界官方变更页https://developer.huawei.com/consumer/cn/doc/doccenter-release-notes/js-apidiff-arkui-7003OverlayManagerOptions 新增 onBackPress。回调类型为 OnOverlayBackPressCallback。返回事件是否被消费必须由弹层状态决定。嵌套弹层需要显式维护栈顶顺序。本文依据 HarmonyOS 7.0.0 ReleaseAPI 26官方变更说明梳理接口并对状态模型、分支选择和异常映射做了宿主侧 TypeScript 测试。当前本机 SDK 为 API 24且没有连接 HDC 设备因此不把示例描述为 API 26 编译通过、真机性能数据或上架审核结论。接入前请在 API 26 工程中按文末清单完成编译、设备与回归验证。两种行为不同的案例案例一筛选弹层单层弹窗只关闭自身。关闭动画期间重复按返回键应被幂等吸收不能穿透到页面路由。案例二图片预览叠加说明弹层先关闭说明层再关闭全屏预览第三次返回才交给页面这要求按栈顶处理而不是用一个布尔值。可复用的 ArkTS 集成片段typeOverlayEntry{id:string;closing:boolean;close:()Promisevoid}exportclassOverlayBackRouter{privatestack:OverlayEntry[][]push(entry:OverlayEntry){this.stackthis.stack.filter(itemitem.id!entry.id)this.stack.push(entry)}remove(id:string){this.stackthis.stack.filter(itemitem.id!id)}asynconBackPress():Promiseboolean{consttopthis.stack.at(-1)if(!top)returnfalseif(top.closing)returntruetop.closingtruetry{awaittop.close()this.remove(top.id)}finally{top.closingfalse}returntrue}}代码刻意把平台调用和业务状态分开平台返回什么就记录什么页面只消费稳定状态。接入时还应补齐项目的日志域、错误码类型和生命周期释放。复现与验证打开详情页并记录页面路由深度。依次打开筛选弹层、图片预览和二级说明层。每按一次返回键记录事件序号、栈顶 ID、回调返回值与页面 URL。确认只有栈为空时回调返回 false页面路由才允许退出。输入/场景预期分支验收信号无弹层false页面接管返回单弹层true只关闭弹层双弹层true只关闭栈顶关闭中重复返回true不重复执行 closeclose 抛错true保留页面记录错误栈清空后返回false页面正常退出取舍与落地清单把所有返回都返回 true 会制造“页面退不出去”把弹层状态交给页面猜测又会产生时序竞争。更稳妥的边界是弹层栈只负责自己是否消费页面路由只处理明确返回 false 的情况。已用 API 26 工程编译并记录 SDK 与设备版本已覆盖“筛选弹层”和“图片预览叠加说明弹层”两类行为已记录成功、失败、降级三条路径的输入与结果已核对监听、对象或任务的释放与幂等行为已把本文宿主测试替换为项目自己的真机证据小结一个可复用的 OverlayBackRouter、嵌套弹层栈规则、6 组状态测试以及接入页面的文件级检查表。。建议先在最小页面复现再接入完整“中式美食”流程先证明状态链正确再谈动画、缓存或埋点优化。