必须用end回调清除Session，因其在弹层DOM彻底销毁、资源完全释放后执行，可100%确保上下文清空；cancel仅响应右上角×点击，beforeClose发生在销毁前，均无法保证终态一致性。

关闭弹层时怎么触发清除 Session 的逻辑

必须用 end 回调，不是 cancel、yes 或 beforeclose。只有 end 能 100% 保证弹层 dom 已销毁、所有资源释放完毕，此时执行清除操作才不会因上下文残留导致失败或重复。

• end 是唯一在 layer 彻底卸载后执行的钩子，适合清理 sessionStorage、localStorage、临时定时器、Vue 实例等
• 如果弹层是 iframe 类型（type: 2），仅在父页 end 里清 session 不够——子页 JS 还在运行，可能继续读写同一份 storage
• 清除前建议加判断：比如检查 sessionStorage.getItem('userToken') 是否存在，避免无意义调用

iframe 弹层中如何同步清除子页的 Session

父页无法直接控制 iframe 内部 JS 生命周期，必须由子页自己响应销毁信号。常见错误是只在父页 end 里删 sessionStorage，结果子页仍拿着旧 token 发请求。

• 在子页（如 /form.html）全局暴露清理函数：window.onDestroy = function() { sessionStorage.clear(); }
• 父页 end 中主动调用：const iframe = layero.find('iframe')[0]; try { iframe.contentWindow.onDestroy?.(); } catch(e) {}
• 务必加 try/catch：跨域 iframe 会抛 SecurityError；同域但子页未定义 onDestroy 会报 undefined is not a function
• 不要依赖 window.name 或 postMessage 做销毁通知——子页可能已提前 unload 或被 Vue Router 替换，消息收不到

为什么不能在 cancel 或 beforeClose 里清 Session

cancel 只响应右上角 × 点击，不覆盖按 Esc、点遮罩、调用 layer.close() 等其他关闭路径；beforeClose 虽然拦截所有关闭，但它发生在 DOM 销毁前，此时子页仍活跃，storage 可能被重写。

Build Session

支持专注的自主工作时段，构建、创作或产出一个具体成果，并高效记录和提交进度。

下载

• cancel 不触发的典型原因：closeBtn: 0 隐藏了按钮，或 iframe 子页里误用了 layer.cancel（应走 parent.layer）
• beforeClose 返回 false 拦住关闭后，用户若再次点击 ×，会再进一次该回调——若你在里面清了 session，第二次就清空了本不该清的内容
• Session 清除是不可逆操作，必须和“弹层彻底退出”这个终态严格绑定，而不是“用户点了关闭按钮”这个中间动作

刷新父页前要确认 Session 已清干净

很多场景下，关闭弹层后要刷新父页列表（比如编辑完回列表页）。如果先 location.reload() 再清 session，新页面加载时可能又从 storage 拿到旧 token，造成状态错乱。

• 正确顺序：先在 end 里清 session（含子页），再 setTimeout(() => { window.parent.location.reload(); }, 50)
• 更稳妥的做法是：清完 session 后发一个自定义事件给父页，由父页监听并决定是否 reload，避免硬编码延迟
• 注意 sessionStorage 是非跨域隔离的，父子页同域才能共享；若用 localStorage，需额外监听 storage 事件做广播同步

实际最易忽略的一点：iframe 子页里的 sessionStorage 和父页是**完全独立**的两个实例，哪怕同域。你以为清了父页的就等于子页也清了，其实没有。必须显式让子页自己执行清除。