layer.msg多次调用会堆叠弹窗，因其默认不排队、不防抖，每次调用均创建独立DOM实例；解决方案是用time+end配合msgIndex手动管理关闭，或通过错误队列+防抖合并提示。
layer.msg 多次调用为什么会堆叠弹窗
因为 layer.msg() 默认不排队、不防抖，每次调用都立即创建一个新 DOM 节点。网络请求并发失败时，5 个接口同时报错，就会生成 5 个独立的 .layui-layer-msg 实例，彼此不感知、不合并、不取消——视觉上就是一串向上堆叠的提示框。
用 layer.msg 的 time + end 参数做简单节流
最轻量的解法是利用 layer.msg() 自带的自动关闭机制，配合手动控制：在下一次调用前先关掉上一个未结束的实例。
-
layer.msg()返回的是 layer 索引值（数字），可存为变量用于后续关闭 - 每次调用前先执行
layer.close(msgIndex)，避免残留 - 设置
time: 2000防止单个提示停留过久，再配end回调清理变量
let msgIndex = null;
function showMsg(text, options = {}) {
layer.close(msgIndex);
msgIndex = layer.msg(text, {
time: 2000,
...options,
end: () => { msgIndex = null; }
});
}
多个错误合并成一条提示的可靠做法
单纯节流只能防“连点”，但无法解决“多请求并发失败”场景下的语义混乱。真正要合并，得靠错误队列 + 防抖计时器，且必须区分错误类型和来源：
- 用
Set或对象键去重相同错误码（如'ERR_NETWORK'） - 对不同错误保留原始信息，但统一包装成“共发生 3 个错误，请检查网络或重试”
- 防抖延迟设为
300ms而非500ms，避免用户等待感过强 - 务必在页面卸载前清空定时器（
beforeunload事件中clearTimeout）
为什么不能只靠 layer.closeAll('msg')？
layer.closeAll('msg') 确实能清空所有消息层，但它有两个硬伤：
- 它不阻塞新
layer.msg()的创建——清完上一秒的，下一毫秒又弹三个 - 它会误杀正在正常工作的其他
msg（比如来自非错误路径的成功提示） - 没有上下文关联：你不知道刚关掉的是哪个请求的错误，也就没法做日志追踪或后端幂等校验
真正可控的方案，始终是“在触发前就决定要不要弹”，而不是“弹了再收拾”。错误提示不是装饰，是状态反馈——它的出现时机和内容精度，直接反映前端控制力是否在线。
