网页 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 工具链和目标设备上编译验证。为避免把接口示意当成证据，应用侧关键判定另写成可执行断言：

class PopupRouter {
  hosts=new Map();
  route(name,opener,request){
    const key=opener+'::'+name; const old=this.hosts.get(key);
    if(old){ old.request=request; return 'reuse'; }
    this.hosts.set(key,{request,state:'open'}); return 'create';
  }
}
const r=new PopupRouter();
if(r.route('preview','main','r1')!=='create') throw new Error('首开失败');
if(r.route('preview','main','r2')!=='reuse') throw new Error('同名窗口未复用');
if(r.route('preview','other','r3')!=='create') throw new Error('跨来源错误复用');

方案不是越复杂越好

方案	适用场景	放弃它的理由
每回调新建窗口	一次性演示页	连点和同名请求制造重复宿主
只按 name 复用	单来源工具	跨来源安全域混淆
来源域 + name 路由	正式多窗 Web 应用	需要生命周期与代际管理

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

最终交付物

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

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

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

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

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

时刻	请求	name	宿主状态	正确动作
T0	A	preview	absent	建立 pending 记录
T1	B	preview	pending(A)	合并或排队，不能再创建
T2	A	preview	bound	绑定控制器并提交导航
T3	B	preview	bound(A)	激活既有窗口并更新目标
T4	close(A)	preview	closing	只释放 A 当前代际

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

一个可复用的 name 路由器

type HostState = 'pending' | 'bound' | 'closing'
type HostRecord = { name: string; requestId: string; generation: number; state: HostState; targetUrl: string }

class NamedWindowRouter {
  private records = new Map<string, HostRecord>()
  begin(name: string, requestId: string, targetUrl: string): HostRecord {
    const old = this.records.get(name)
    if (old && old.state !== 'closing') { old.targetUrl = targetUrl; return old }
    const next = { name, requestId, targetUrl, generation: (old?.generation ?? 0) + 1, state: 'pending' as HostState }
    this.records.set(name, next)
    return next
  }
  bind(name: string, requestId: string): boolean {
    const item = this.records.get(name)
    if (!item || item.requestId !== requestId || item.state !== 'pending') return false
    item.state = 'bound'; return true
  }
  close(name: string, generation: number): boolean {
    const item = this.records.get(name)
    if (!item || item.generation !== generation) return false
    this.records.delete(name); return true
  }
}

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 工具链和目标设备上编译验证。为避免把接口示意当成证据，应用侧关键判定另写成可执行断言：

class PopupRouter {
  hosts=new Map();
  route(name,opener,request){
    const key=opener+'::'+name; const old=this.hosts.get(key);
    if(old){ old.request=request; return 'reuse'; }
    this.hosts.set(key,{request,state:'open'}); return 'create';
  }
}
const r=new PopupRouter();
if(r.route('preview','main','r1')!=='create') throw new Error('首开失败');
if(r.route('preview','main','r2')!=='reuse') throw new Error('同名窗口未复用');
if(r.route('preview','other','r3')!=='create') throw new Error('跨来源错误复用');

方案不是越复杂越好

方案	适用场景	放弃它的理由
每回调新建窗口	一次性演示页	连点和同名请求制造重复宿主
只按 name 复用	单来源工具	跨来源安全域混淆
来源域 + name 路由	正式多窗 Web 应用	需要生命周期与代际管理

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

最终交付物

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

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

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

官方资料

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