Layui 无法内置 AdBlock 检测,需手动实现“资源加载+尺寸 fallback”双校验:创建隐藏 promo-slot 元素并发起 /pixel.gif 请求,100ms 后两者均异常才判定开启广告拦截,并用 layer.alert 或原生 alert 提示用户。

直接检测不现实——Layui 本身没有内置 AdBlock 检测能力,它只是 UI 框架,不处理广告拦截逻辑。所有检测都得靠你自己写 JavaScript,且必须绕过当前主流拦截器(uBlock Origin、AdGuard、AdBlock Plus)的反检测机制。
为什么老方法在 Layui 里基本失效
很多项目还在用 document.querySelector('.adsbox') 或加载 ads.js 的方式,但这些在 2026 年已大面积失效:
- uBlock Origin 默认启用「anti-adblock」过滤规则(来自 EasyList+Fanboy’s Annoyance List),会主动隐藏或删除检测用 DOM 元素
- AdGuard 会拦截所有含
/ad/、/ads/、/googlead/路径的请求,连 fetch 都发不出去 - Layui 的
layer.msg或layer.alert本身不会触发检测,但如果你把提示逻辑塞进被拦截的 JS 文件里,它根本不会执行
可行的检测思路:用「资源加载 + 尺寸 fallback」双保险
单一维度(只看 height、只看 display、只看 fetch 状态)容易被绕过。推荐组合判断,且避免敏感词:
- 创建一个带非敏感类名的 ,比如
class="promo-slot",不叫ad、banner、adsbox- 给它设固定宽高(如
width: 1px; height: 1px;)、绝对定位、不透明度 0,避免影响布局- 同时发起一个极简资源请求(如
fetch('/pixel.gif'),文件大小 1B,路径不含 ad)- 100ms 后检查:
promo-slot是否offsetWidth === 0且fetch被拒绝/超时- 两者同时成立,才认为 AdBlock 极大概率开启
在 Layui 页面中嵌入检测并弹窗提醒
别把检测逻辑写在
layui.use里——它可能等不到模块加载完就被拦截了。直接放在<script></script>标签中,越早执行越好:<script> (function() { const testEl = document.createElement('div'); testEl.className = 'promo-slot'; testEl.style.cssText = 'position:absolute;top:-9999px;left:-9999px;width:1px;height:1px;opacity:0;'; document.body.appendChild(testEl); let blocked = false; const check = () => { if (testEl.offsetWidth === 0 && testEl.offsetHeight === 0) blocked = true; }; setTimeout(check, 100); fetch('/pixel.gif', { method: 'HEAD', cache: 'no-cache' }) .catch(() => blocked = true) .finally(() => { if (blocked) { // 确保 layer 已加载 if (typeof layer !== 'undefined') { layer.alert('我们检测到广告拦截插件正在运行。为保障功能完整,请将其暂时关闭或添加本站到白名单。', { title: '温馨提示', yes: () => location.reload() }); } else { // layer 还没 ready?降级用原生 alert alert('广告拦截插件已启用,请关闭后刷新页面。'); } } document.body.removeChild(testEl); }); })(); </script>注意:
/pixel.gif必须真实存在且返回 200,否则会被当成网络错误误判;如果服务器不能配静态资源,可改用new Image().src = '/pixel.gif'替代 fetch。最容易被忽略的坑:缓存、CDN 和 CSP
即使检测逻辑写对了,也可能因以下原因失败:
- CDN 缓存了被拦截的 JS,导致用户始终拿到旧版检测代码(尤其是用了 Cloudflare Auto Minify 的项目)
- 你的 CSP 策略禁了
connect-src,导致fetch直接被浏览器拦截,和 AdBlock 无关却误报 - 测试时用隐身窗口但忘了禁用所有扩展——某些隐私类插件(如 Privacy Badger)也会干扰 DOM 尺寸测量
- Layui 的
layer.alert依赖layui.css,如果 CSS 被拦截,弹窗样式会崩,但逻辑仍可执行
上线前务必用 uBlock Origin 默认规则 + EasyList + Annoyance List 全开环境实测,别信本地开发时的“能弹出来”。
- 给它设固定宽高(如











