beforeEnd 回调必须返回 Promise 才能阻塞关闭：返回 false 或 rejected Promise 取消关闭，resolved Promise 允许继续；2.9.11+ 支持，需显式 return；iframe 层需父页处理；并发关闭需防重；reject 后须手动恢复 UI 并提示。
beforeEnd 回调必须返回 Promise 才能真正阻塞关闭
layer 的 beforeend 是唯一能在关闭前介入并控制是否关闭的钩子，但它不是“自动等待异步”的魔法——如果你在里面 await fetch() 却没 return 这个 promise，layer 会当成同步执行、立刻关闭。关键点是：返回值决定行为，false 或被 reject 的 promise 会取消关闭，resolved 的 promise 则允许继续。
- ✅ 正确写法：在
beforeEnd函数体末尾显式return一个 Promise（哪怕只是Promise.resolve()） - ❌ 错误写法：
beforeEnd: async () => { await cleanup(); }—— 箭头函数隐式返回undefined，layer 视为“无返回”，直接关闭 - ⚠️ 注意：2.9.11+ 版本才支持 Promise 返回，低于此版本的
beforeEnd只认false同步阻断
清理失败时如何保持弹窗并提示用户
用户点了关闭按钮，但后端返回“正在被他人编辑”，你得拦住关闭、给提示、让用户知道发生了什么。这时候不能只靠 return false，因为那会丢失错误上下文；也不能直接 layer.msg() 就完事——它可能被遮挡或一闪而过。
- 在
beforeEnd中用try/catch包裹异步请求，失败时layer.msg('保存中… 请稍候', {icon: 16})并return Promise.reject() - 避免在 catch 里调
layer.close()—— 这会导致二次关闭冲突，layer 内部已进入关闭流程 - 如果清理逻辑含 UI 操作（如禁用按钮），建议在
beforeEnd开始就操作 DOM，否则用户可能反复点击关闭按钮触发多次请求
iframe 弹窗里调用 beforeEnd 的特殊限制
type:2 的 iframe 层，beforeEnd 回调是在父页面上下文中执行的，但你常需要从 iframe 子页触发清理（比如提交表单前校验）。这时不能直接在子页写 beforeEnd，得换路径。
- 子页不定义
beforeEnd，改用parent.layer.getFrameIndex(window.name)拿到自己的 index - 子页监听窗口即将关闭事件（如
window.onbeforeunload），手动发请求；成功后调parent.layer.close(index)，失败则return '请先保存更改'阻断刷新 - 父页 open 时可传入
end回调，在里面做兜底清理，但注意：end 是关闭后触发，无法阻止关闭本身 - 别依赖
window.name的稳定性——某些打包工具或广告脚本会改写它，建议 open 时显式设name: 'edit-user-' + Date.now()
关闭前异步清理和 layer.closeAll() 的兼容性问题
当页面存在多个弹窗，你调 layer.closeAll('iframe') 时，每个 iframe 层的 beforeEnd 会并发执行。如果它们都去调同一个接口（如“释放资源锁”），后端可能拒绝重复请求，导致部分弹窗卡在关闭中。
- 对共享资源的清理，建议加防重标识，比如在弹窗 open 时生成唯一
lockId，清理时带上它，服务端幂等处理 - 不要在
beforeEnd里调layer.closeAll()—— 它会递归触发其他弹窗的beforeEnd，极易死循环或索引错乱 - 2.9.24 版本中，
beforeEnd返回 Promise 后，若未 resolve，弹窗 DOM 仍存在但失去焦点，此时再点遮罩层可能触发不可预期的cancel回调
beforeEnd 的 Promise 被 reject 后，弹窗视觉上没关，但内部状态已进入“待销毁”，DOM 事件监听可能失效；这时候用户再点一次关闭，容易漏掉第二次的清理逻辑。务必在 reject 后手动恢复按钮/输入框可用性，并明确告知用户下一步该做什么。
