首页 > Wordpress > 正文

微信里打开文章白屏?四步定位

fenij 2026-08-31 33 Wordpress

读者在微信里把你的文章链接发出去,对方点开却是一片白屏——但用 Safari、Chrome 打开好好的。这不是服务器挂了,是微信内置浏览器(X5 内核 / TBS)的兼容性或网络栈问题。先给结论:八成出在混合内容、缓存脏、或某段 JS 在特定内核下静默失败。下面四步定位,基本能揪出来。

白屏和”打不开”不是一回事

微信里两种现象要分开:一种是真白屏(页面已加载,但渲染层空白,文字还能盲选复制);另一种是转圈打不开(请求根本没回来)。前者多半是前端渲染或混合内容,后者偏网络或 WAF。定位前先让对方在微信里点右上角「…」→「在浏览器打开」试一下:能开说明站点本身没问题,锅在微信内核;还白屏才往服务器查。

第一步:揪混合内容(最常见)

页面是 HTTPS,但里面某张图、某个 JS 还是 http:// 写死,微信 X5 在 Android 12+ 会静默拦截非 HTTPS 资源,整页就白了。用 Why No Padlock 或浏览器开发者工具看 Console,把 http:// 资源全改成 https://。WordPress 里最快的办法:装 SSL Insecure Content Fixer 插件,或在 functions.php 加过滤器把输出里的 http 替成 https。

第二步:清微信 X5 缓存

X5 内核缓存特别顽固,你改了 CSS 它还在用旧版。让对方在微信聊天框输入 //debugtbs.qq.com 发出来,点「清除 TBS 内核」→「安装线上版本」,重启微信再试。服务端也可以给静态资源加版本号,强制刷新:

add_filter('style_loader_src', function($src){
    return add_query_arg('ver', time(), $src);
});
add_filter('script_loader_src', function($src){
    return add_query_arg('ver', time(), $src);
});

第三步:看是不是 CDN / WAF 拦了

站点套了 Cloudflare 或自建 WAF 时,微信 X5 的 User-Agent(带 TBS 标识)常被当成”非标爬虫”直接 403。去 Cloudflare 的 Security → Events 看有没有 /wp-content/ 被 Block,给微信 UA 加一条 WAF 放行,或对文章路径做例外。别一上来就关掉整个 CDN——那会丢了缓存和防护。

第四步:JS 在 X5 下静默崩

有些 ES6+ 或实验性 API 在 X5 老内核不报错只白屏。让对方用「在浏览器打开」能看,基本就能锁定是 JS 兼容。临时止血:把主题里花哨的动画、Google Fonts 换成系统字体;正式修法是用 Babel 把 JS 转到 ES5,或给关键脚本加 try/catch 兜底,崩了也不连累整页。

踩坑实录

我帮一个客户查过:文章在自己手机 Chrome 正常,发给同事的微信里全白。我在 Chrome 里开 DevTools 一看 Console,满屏 Mixed Content: The page was loaded over HTTPS but requested an insecure script——主题里一个统计 JS 写死 http://。微信 X5 在 Android 上直接吞掉这个脚本,而那脚本刚好负责初始化渲染,于是整页白。改成 https 后微信里立刻正常。教训就一句:HTTPS 站点里但凡有一个 http 资源,微信里就可能白给你看。

四步排查速查

步骤 查什么 快速动作
① 混合内容 页面里有 http 资源 全改 https,装 SSL 修复插件
② 清缓存 X5 用了旧静态资源 发 //debugtbs.qq.com 清内核
③ CDN/WAF 微信 UA 被拦 403 Security Events 加微信 UA 放行
④ JS 兼容 ES6+ 在 X5 静默崩 转 ES5,关键脚本 try/catch

常见问题

Q:只有安卓微信白屏,iOS 正常?
A:典型 X5 内核 + 混合内容或老 JS。iOS 用 WKWebView 容错更好,优先按第一、四步修。

Q:点「在浏览器打开」能看,说明服务器没问题吧?
A:基本可以排除服务器和 PHP 问题,集中精力查微信内核兼容、混合内容、CDN/WAF。

Q:清了 TBS 缓存还是白?
A:那说明是内容本身问题(混合内容或 JS 崩),清缓存治标不治本,回到第一、四步。

你在微信里分享文章遇到过白屏吗?把现象甩在 fenij.com 留言区,我帮你对着排。

相关完整手册

系统化的排查与配置思路,建议顺手收藏这几篇完整手册: