layer.msg 弹窗被遮挡主因是层叠上下文干扰而非 z-index 失效，需确保其 DOM 插入 body 根节点、避免被定位父容器包裹，并排查框架渲染、UI 组件或 CSS 属性引发的上下文隔离。
layer.msg 弹窗被遮挡时 z-index 不生效？
不是 z-index 没用，而是它只对「定位元素」起作用，而 layer.msg 默认生成的 DOM 节点被插入到 底部，若页面中存在父级设置了 position: relative/absolute/fixed 且 z-index 较高的容器（比如导航栏、弹窗遮罩层、自定义 modal），就会形成新的层叠上下文，把 layer.msg “框死”在局部层级里。
解决思路不是盲目调高 z-index，而是确保 msg 节点脱离所有干扰上下文：
- 手动指定
layer.msg的挂载容器为根节点，避免被中间层包裹 - 检查是否启用了
layer.config({ zIndex: ... })，该配置会影响所有 layer 组件的基准层级，但不改变 DOM 插入位置 - 若项目中用了 Vue/React 等框架，注意不要把
layer.msg调用写在组件内部生命周期里，导致其被渲染到组件 DOM 子树下（这是最隐蔽的遮挡原因）
如何强制 layer.msg 插入到 最外层？
Layui 的 layer.msg 默认就插在 ，但如果你或第三方代码调用了 layer.setTop()、或全局修改了 layer.zIndex、或使用了 layer.open 配合 type: 1 自定义内容并误设了 fixed: false，都可能导致后续 msg 被“继承”错误上下文。
稳妥做法是显式控制插入点：
- 调用前重置 layer 的基础配置：
layer.config({ path: '/path/to/layer/', zIndex: 19891014 });（注意：这个zIndex是 layer 内部生成新层时的起始值，不是 CSS 的 z-index） - 确保没在任何地方调用
layer.setTop()—— 它会把后续所有 layer 元素插入到当前 top window 的 document.body 下，但在 iframe 或 shadow DOM 场景下可能失效 - 如果仍不行，可手动移除旧 msg 节点再重建：
$('body > .layui-layer-msg').remove(); layer.msg('xxx');
常见遮挡场景与对应修复方式
真实项目里，遮挡往往来自具体 UI 组件，不是 layer 本身问题：
-
Ant Design / Element UI 的 Modal 或 Drawer：它们内部设置了很高的
z-index（如 2000+），且创建了独立层叠上下文。修复：给layer.msg加上offset: 't'或time: 0配合手动layer.closeAll()避免叠加；或改用layer.tips定向提示 -
自定义 fixed 导航栏 + z-index: 999：即使 msg 在 body 下，只要导航栏开启了
transform、opacity、will-change等属性，也会创建新层叠上下文。修复：临时降低导航栏的z-index，或给 msg 手动加style="z-index: 999999 !important;"（仅应急） -
Vue 单文件组件中调用 layer.msg：尤其在
mounted或watch中触发，容易因组件 DOM 尚未完全挂载或被 portal 渲染机制影响，导致 msg 节点被 append 到组件根元素内。修复：用setTimeout(() => layer.msg(...), 0)推迟执行，或直接在created阶段调用
为什么改 layer.zIndex 配置有时没反应？
因为 layer.zIndex 只决定 layer 内部各类型弹窗（msg/tips/confirm等）之间的相对顺序，不改变它们相对于页面其他元素的层级关系。真正起作用的是浏览器渲染时的「层叠上下文树」，而这个树由 DOM 结构 + CSS 定位属性共同决定。
所以别只盯着配置项，重点看三件事：
- 打开浏览器开发者工具，选中 msg 元素，看它的
offsetParent是不是body；如果不是，说明它被某个定位父容器“收编”了 - 检查 msg 元素的 computed
z-index值，以及它父级链上第一个非static定位元素的z-index和是否创建了层叠上下文 - 用
getComputedStyle(document.body).zIndex确认 body 是否意外被设了z-index（极少见，但一旦有，整个 body 就成了层叠上下文根）
复杂点在于：一个页面里可能同时存在多个层叠上下文，而 msg 只能在一个上下文中找位置。这时候靠调数字没用，得动手拆上下文。
