企业官网建设流程全解析

网页 window.open 连点两次为什么串到同一个窗口：HarmonyOS 7 ArkWeb name 路由怎么防重入

网页连续两次调用window.open(url, "preview")，应用侧创建了两个窗口，但后一次内容跑进前一个窗口；关闭其中一个后，另一个也失去控制器。官方文档说明 ArkWeb 会根据 name 查找已绑定 Web 组件，而 API 26 的onWindowNewExt()还带来 NavigationPolicy 与 WindowFeatures。工程上要把 name、请求代际和宿主生命周期放进同一套路由，而不能每次回调都无条件 new 窗口。

证据边界：文中 API 26/HarmonyOS 7 能力以华为当前官方文档为准；代码中的应用侧状态与一致性断言已在本机 Node.js 环境执行。当前本机 SDK 为 API 24，且没有连接 HarmonyOS 7 真机，因此本文不声称完成 API 26 编译、真机性能或上架审核验证。

先把故障钉在可复现步骤上

在测试网页中快速执行两次同名window.open，再执行一次不同 name 的打开请求。应用侧记录 openerId、windowName、requestId、navigationPolicy、windowFeatures 和 hostState。复现目标是：同名请求重用既有宿主，不同 name 隔离，关闭回调只能释放对应绑定。

案例一：预览窗口应重用而不是复制

同一个preview已经绑定时，第二次请求更新其导航目标并激活窗口。若仍创建新宿主，ArkWeb 的 name 绑定与应用窗口表会发生分歧。

案例二：支付窗口必须拒绝跨来源复用

即使 name 相同，只要 opener 或受信来源不同，就不能静默复用已有宿主。路由表应把业务安全域纳入 key，并在不满足策略时拒绝或新建隔离窗口。

先分清同名复用和重复回调

onWindowNewExt()与onWindowNew()同时配置时，官方说明只触发增强接口。不要为了兼容而在两个回调里都创建窗口。收到增强事件后，先查 name 绑定，再核对 opener 和策略，最后决定复用、隔离或拒绝。

窗口表要保存“谁能关闭谁”

路由记录至少包含 windowName、hostWindowId、webControllerId、openerId、generation 和 state。关闭事件带 requestId 进入时，只能关闭仍由这一代请求拥有的宿主；迟到的旧 close 不能把新页面一起销毁。

WindowFeatures 是约束输入，不是绝对命令

网页给出的窗口位置和大小需要经过设备、自由多窗状态与产品规则校验。应用可以映射成安全范围，不应把网页参数直接当作系统窗口最终几何结果。

可直接放进工程的接口片段

Web({src:$rawfile('window.html'),controller:this.controller}).multiWindowAccess(true).onWindowNewExt((event)=>{// 读取 event 中的增强导航策略与窗口特征，交给受控路由表。this.popupRouter.route(event)})// 当同时注册新旧回调时，以官方文档所述的 onWindowNewExt 行为为准。

上面是围绕官方接口位置整理的 ArkTS/工程片段，仍需在 API 26 工具链和目标设备上编译验证。为避免把接口示意当成证据，应用侧关键判定另写成可执行断言：

classPopupRouter{hosts=newMap();route(name,opener,request){constkey=opener+'::'+name;constold=this.hosts.get(key);if(old){old.request=request;return'reuse';}this.hosts.set(key,{request,state:'open'});return'create';}}constr=newPopupRouter();if(r.route('preview','main','r1')!=='create')thrownewError('首开失败');if(r.route('preview','main','r2')!=='reuse')thrownewError('同名窗口未复用');if(r.route('preview','other','r3')!=='create')thrownewError('跨来源错误复用');

方案不是越复杂越好

采用来源安全域与 name 组成的路由 key，并把 WindowFeatures 当作布局建议。这样既符合网页同名窗口的直觉，又不会让不可信来源复用敏感宿主。

最终交付物

一张 popup 路由表、可执行的重复请求断言，以及窗口关闭回收规则。接入后所有onWindowNewExt请求都走统一入口。

• 同一 opener 的同名窗口只保留一个宿主。
• 不同 opener 不共享敏感窗口。
• 旧 close 回调不能关闭新一代宿主。
• 窗口位置大小先做设备边界校验。
• 不同时在新旧回调里创建窗口。

多窗口问题常被误判成 Web 内容问题。先把 name、来源和窗口所有权路由清楚，连点、重入和关闭竞态都会有确定答案。

先画出同名窗口的竞态时间线

问题通常发生在两个回调几乎同时进入应用层时：请求 A 还没完成宿主绑定，请求 B 已经看到 name 相同并开始复用。如果窗口表只有 name，没有 requestId 和绑定阶段，B 就可能拿到一个尚未就绪的控制器。

这张表把“偶现串窗”变成可记录的状态转换。日志至少保留 openerId、windowName、requestId、generation、hostId、navigationPolicy 和最终动作。

一个可复用的 name 路由器

typeHostState='pending'|'bound'|'closing'typeHostRecord={name:string;requestId:string;generation:number;state:HostState;targetUrl:string}classNamedWindowRouter{privaterecords=newMap<string,HostRecord>()begin(name:string,requestId:string,targetUrl:string):HostRecord{constold=this.records.get(name)if(old&&old.state!=='closing'){old.targetUrl=targetUrl;returnold}constnext={name,requestId,targetUrl,generation:(old?.generation??0)+1,state:'pending'asHostState}this.records.set(name,next)returnnext}bind(name:string,requestId:string):boolean{constitem=this.records.get(name)if(!item||item.requestId!==requestId||item.state!=='pending')returnfalseitem.state='bound';returntrue}close(name:string,generation:number):boolean{constitem=this.records.get(name)if(!item||item.generation!==generation)returnfalsethis.records.delete(name);returntrue}}

requestId 防止迟到回调绑定到新请求，generation 防止旧窗口的关闭通知误删新宿主。真实 ArkWeb 控制器仍要按官方接口生命周期接入；这段模型只验证应用层路由规则。

三条日志就能判断是哪一层串了

1. 同一 name 同时出现两个 create-host：应用层没有合并 pending 请求。
2. bind 的 requestId 与当前记录不同：迟到回调污染了新代际。
3. 关闭一个窗口后记录表直接按 name 删除：旧关闭事件没有校验 generation。

最终验收覆盖快速双击、不同 name 并发、创建失败回滚、旧窗口迟到关闭和应用进程恢复五组路径。

官方资料

• ArkWeb 在新窗口中打开页面
• Web 组件跨窗口迁移
• HarmonyOS 7 升级适配指南

网页 window.open 连点两次为什么串到同一个窗口：HarmonyOS 7 ArkWeb name 路由怎么防重入

网页连续两次调用window.open(url, "preview")，应用侧创建了两个窗口，但后一次内容跑进前一个窗口；关闭其中一个后，另一个也失去控制器。官方文档说明 ArkWeb 会根据 name 查找已绑定 Web 组件，而 API 26 的onWindowNewExt()还带来 NavigationPolicy 与 WindowFeatures。工程上要把 name、请求代际和宿主生命周期放进同一套路由，而不能每次回调都无条件 new 窗口。

证据边界：文中 API 26/HarmonyOS 7 能力以华为当前官方文档为准；代码中的应用侧状态与一致性断言已在本机 Node.js 环境执行。当前本机 SDK 为 API 24，且没有连接 HarmonyOS 7 真机，因此本文不声称完成 API 26 编译、真机性能或上架审核验证。

先把故障钉在可复现步骤上

在测试网页中快速执行两次同名window.open，再执行一次不同 name 的打开请求。应用侧记录 openerId、windowName、requestId、navigationPolicy、windowFeatures 和 hostState。复现目标是：同名请求重用既有宿主，不同 name 隔离，关闭回调只能释放对应绑定。

案例一：预览窗口应重用而不是复制

同一个preview已经绑定时，第二次请求更新其导航目标并激活窗口。若仍创建新宿主，ArkWeb 的 name 绑定与应用窗口表会发生分歧。

案例二：支付窗口必须拒绝跨来源复用

即使 name 相同，只要 opener 或受信来源不同，就不能静默复用已有宿主。路由表应把业务安全域纳入 key，并在不满足策略时拒绝或新建隔离窗口。

先分清同名复用和重复回调

onWindowNewExt()与onWindowNew()同时配置时，官方说明只触发增强接口。不要为了兼容而在两个回调里都创建窗口。收到增强事件后，先查 name 绑定，再核对 opener 和策略，最后决定复用、隔离或拒绝。

窗口表要保存“谁能关闭谁”

路由记录至少包含 windowName、hostWindowId、webControllerId、openerId、generation 和 state。关闭事件带 requestId 进入时，只能关闭仍由这一代请求拥有的宿主；迟到的旧 close 不能把新页面一起销毁。

WindowFeatures 是约束输入，不是绝对命令

网页给出的窗口位置和大小需要经过设备、自由多窗状态与产品规则校验。应用可以映射成安全范围，不应把网页参数直接当作系统窗口最终几何结果。

可直接放进工程的接口片段

Web({src:$rawfile('window.html'),controller:this.controller}).multiWindowAccess(true).onWindowNewExt((event)=>{// 读取 event 中的增强导航策略与窗口特征，交给受控路由表。this.popupRouter.route(event)})// 当同时注册新旧回调时，以官方文档所述的 onWindowNewExt 行为为准。

上面是围绕官方接口位置整理的 ArkTS/工程片段，仍需在 API 26 工具链和目标设备上编译验证。为避免把接口示意当成证据，应用侧关键判定另写成可执行断言：

classPopupRouter{hosts=newMap();route(name,opener,request){constkey=opener+'::'+name;constold=this.hosts.get(key);if(old){old.request=request;return'reuse';}this.hosts.set(key,{request,state:'open'});return'create';}}constr=newPopupRouter();if(r.route('preview','main','r1')!=='create')thrownewError('首开失败');if(r.route('preview','main','r2')!=='reuse')thrownewError('同名窗口未复用');if(r.route('preview','other','r3')!=='create')thrownewError('跨来源错误复用');

方案不是越复杂越好

采用来源安全域与 name 组成的路由 key，并把 WindowFeatures 当作布局建议。这样既符合网页同名窗口的直觉，又不会让不可信来源复用敏感宿主。

最终交付物

一张 popup 路由表、可执行的重复请求断言，以及窗口关闭回收规则。接入后所有onWindowNewExt请求都走统一入口。

• 同一 opener 的同名窗口只保留一个宿主。
• 不同 opener 不共享敏感窗口。
• 旧 close 回调不能关闭新一代宿主。
• 窗口位置大小先做设备边界校验。
• 不同时在新旧回调里创建窗口。

多窗口问题常被误判成 Web 内容问题。先把 name、来源和窗口所有权路由清楚，连点、重入和关闭竞态都会有确定答案。

官方资料

• ArkWeb 在新窗口中打开页面
• Web 组件跨窗口迁移
• HarmonyOS 7 升级适配指南