根本原因是子页面执行 parent.layer.close() 时父页面 layer 模块未就绪或未挂载到 parent 全局作用域，因 layui.layer 需通过 layui.use 异步加载且 iframe 子页无法感知其状态，必须由父页显式暴露关闭函数。
子页面调用 parent.layer.close 报错 “undefined is not a function”
根本原因是子页面加载时，父页面的 layer 模块还没就绪，或者没挂载到 parent 全局作用域。layui 的 layer 不是自动全局暴露的——它依赖 layui.use('layer', callback) 异步加载，而 iframe 子页无法直接感知父页模块加载状态。
- 父页面必须显式把
layer实例或封装好的关闭函数挂到window或parent上，例如：window.parentLayer = layer;或parent.closeLayer = function(index) { layer.close(index); }; - 子页面不能直接写
parent.layer.close()，除非你 100% 确保父页已执行layui.use('layer')且未包裹在$(document).ready或其他异步回调里（这些会延迟暴露） - 更稳妥的做法：父页在
layer.open的success回调中挂载函数，此时layer必然可用：parent.closeChild = function(index) { layer.close(index); };
parent.layer.getFrameIndex(window.name) 返回 -1 或报错
这个函数依赖 iframe 的 window.name 与 layer 内部索引映射表匹配。一旦 window.name 被子页脚本覆盖、清空，或父页未启用该机制（旧版 Layui），就会失效。
- 不要手动改
window.name—— Layui 用它做索引标识，子页 JS 里任何window.name = 'xxx'都会破坏关联 - 优先用
parent.layer.getFrameIndex(layero.find('iframe')[0].name)（在父页success中获取），或让父页把index通过 URL 参数传入子页：content: '/form.html?layerIndex=' + index - Layui 2.8+ 支持
parent.layer.getFrameIndex(window.name)，但前提是子页没篡改window.name，且父页 layer 实例存在
跨域 iframe 下 parent.layer 完全不可访问
浏览器同源策略会拦截所有 parent.xxx 访问，控制台报 Blocked a frame with origin 'xxx' from accessing a cross-origin frame。这不是 Layui 的问题，是浏览器强制行为。
- 同源方案：确保子页 URL 与父页协议、域名、端口完全一致（包括 www 和非 www 差异）
- 跨域方案：必须用
postMessage，父页监听window.addEventListener('message', e => { if (e.origin !== 'https://trusted.com') return; ... })，子页调用parent.postMessage({ type: 'closeAndReturn', data: {...} }, 'https://parent-domain.com'); - 别尝试绕过：
document.domain在现代浏览器中已被废弃，window.opener在 iframe 场景下也不可靠
子页面执行 parent.layer.close() 后回调函数不触发
不是函数没定义，而是执行顺序错了。Layui 关闭动画开始后，iframe DOM 会快速销毁，紧接着调用 parent.xxxCallback() 就可能找不到目标对象。
- 严格按顺序：先调用
parent.layer.close(index)，再立即调用parent.xxxCallback(data)—— 二者必须在同一同步任务中，不能用setTimeout或 Promise 延迟 - 父页接收函数必须提前挂载在
window或parent上，且不能是局部变量或闭包内函数（比如写在layui.use回调里却没挂到全局） - 子页调用前加防护：
if (typeof parent.receiveData === 'function') { parent.receiveData(data); }，避免因挂载时机问题导致崩溃
layer 模块加载时机和子页面脚本执行时机之间存在竞态，而开发者常默认“只要写了 layui.use('layer') 就万事大吉”。真实情况是，子页 JS 可能在父页 layui.use 回调执行前就运行了，这时候任何 parent.layer.xxx 都是 undefined。
