layui.ajax 全局 error 监听必须在 layui.use 加载 jquery 后生效，且需通过 layui.config({ajax: {error: fn}}) 在 layui.use 前配置（仅 2.8+ 支持）；直接在单个请求中写 error 回调仅为局部处理，无法捕获超时、跨域等错误。
layui.ajax 全局 error 监听必须用 layui.use 包裹初始化
直接写 layui.ajax({error: function(){...}}) 不会生效——layui 的全局错误监听不是靠单个请求配置，而是依赖 layui.use(['jquery'], ...) 后对 $ 对象的原型扩展。没走模块加载流程，$.ajax 就只是原生 jquery 行为，不触发 layui 的拦截逻辑。
正确做法是：在 layui.use 回调里，先确保 jquery 已加载，再调用 layui.ajax 或给 $ 打补丁：
- 用
layui.ajax替代$.ajax，它天然支持全局 error 钩子 - 若必须用
$.ajax，需手动监听：$(document).ajaxError(...)（但该方式无法捕获超时、跨域等非 HTTP 错误） - 推荐统一入口：所有请求走
layui.ajax，并在其前统一注册layui.config({debug: true})方便定位问题
layui.ajax 的全局 error 回调要写在 layui.config 之后、layui.use 之前
很多人把 error 处理函数塞进 success 或 error 字段里，这是局部处理；全局监听需要更早介入。Layui 提供了 layui.config({ajax: {error: function(){...}}}) 接口，但它只在 2.8+ 版本有效，且必须在 layui.use 调用前执行。
常见错误现象：layer.open 报 layer is not defined，本质是 error 回调里用了未加载的模块。
- 确保
layer已声明：在layui.use(['jquery', 'layer'], function(){...})中使用 - 不要在 config 的 error 里直接调用
layer.alert，应改用setTimeout延迟或提取为独立函数 - 错误回调中避免访问 DOM 元素（如
$('#xxx')），因为此时页面可能尚未就绪
layer 弹窗在 ajax error 中报未定义，大概率是模块加载顺序错
典型报错：Uncaught ReferenceError: layer is not defined，发生在 error: function(){ layer.msg('网络异常') } 里。这不是代码写错了，而是 layer 模块根本没被 layui.use 加载进来。
真实场景中，很多项目用的是 H-ui.admin 或二次封装框架，它们默认只加载 jquery 和 form，漏掉 layer。
- 检查
layui.use参数数组是否包含'layer' - 确认引入的是
layui.all.js而非精简版layui.js（后者需显式 require） - 如果用 CDN，确保地址带版本号，例如
https://cdn.jsdelivr.net/npm/layui@2.9.15/dist/layui.all.js，避免缓存旧版 - error 回调里不要写
return false，否则可能中断后续错误传播链
弹窗提示后页面跳转或刷新导致 layer 关闭失效
常见表现：弹出「登录过期」提示后，用户点确定，页面却直接跳转或刷新，导致 layer.close 未执行或被丢弃。这不是 layer 的 bug，而是浏览器行为优先级问题。
根本原因是：表单按钮默认 type="submit"，点击即触发表单提交 + 页面刷新，覆盖了 JS 异步回调。
- 表单按钮务必加
type="button"，禁用默认提交行为 - 在 ajax error 中做跳转，用
window.location.replace('/login')替代window.location.href = '/login'，避免历史栈污染 - 如果必须刷新，先
layer.closeAll()，再setTimeout(() => location.reload(), 300)，留出关闭动画时间 - 不要在 error 回调里嵌套
layer.confirm后立刻跳转，用户还没点确定就刷了页面
layui.use(['layer']) 就万事大吉，但若该脚本块位于 DOM 加载完成前（比如放在 layer 可能因依赖的 CSS 未加载完而初始化失败。
