白屏主因是HTML5页面在WebView中执行出错或资源加载失败。需先确认调试通道：Android启用setWebContentsDebuggingEnabled，iOS用真机+Safari调试；检查资源MIME类型、本地协议限制、框架模板编译及WebView线程与生命周期管理。
页面白屏大概率是 HTML5 页面在 WebView 中执行出错或资源加载失败，而非“渲染卡死”本身。
WebView 控制台日志根本看不到？先确认调试通道是否打通
很多白屏问题其实连 JS 错误都没报出来，因为默认 WebView 关闭了远程调试或未注入调试桥接脚本。
- Android：确保
WebView.setWebContentsDebuggingEnabled(true)在 Application 或 Activity 初始化时调用（仅 debug 包启用） - iOS：必须用真机 + Safari → 开发者菜单 → 选择设备和对应 WebView 页面，模拟器不支持 Web Inspector
- Hybrid 框架（如 Cordova、Capacitor）需检查插件是否启用
console重定向，否则console.log会静默丢弃 - 若仍无日志，可在 JS 入口最顶部加
try/catch包裹整个初始化逻辑，并用alert()或原生 Toast 输出异常信息（临时手段，定位后移除）
白屏但控制台无报错？重点查资源加载拦截与 MIME 类型
WebView（尤其 Android 4.4+ 的 Chromium 内核）对资源响应头更严格，常见于本地 file:// 协议或未配 Content-Type 的本地服务器。
- 检查 HTML 中
<script src="js/app.js"></script>是否被 WebView 拦截：通过WebViewClient.shouldInterceptRequest()打印所有请求 URL 和返回的WebResourceResponse - 本地开发时若用
file://加载，iOS WKWebView 默认禁止XMLHttpRequest和fetch加载本地 JSON/JS；需改用http://127.0.0.1:8080启服务（推荐serve或http-server） - 检查服务器返回的 JS/CSS 文件是否带正确
Content-Type：JS 必须是text/javascript或application/javascript，CSS 必须是text/css；Nginx/Apache 配置遗漏会导致 Chrome 内核拒绝执行
Vue/React 页面白屏？别只盯着 mounted，先看模板编译是否失败
SPA 框架的白屏常发生在模板解析阶段，错误发生在 new Vue() 或 ReactDOM.render() 之前，控制台可能只显示 “Failed to load module script” 或空白控制台。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
立即学习“前端免费学习笔记（深入）”；
- Vue CLI 构建后检查
index.html中的script标签路径是否正确：相对路径在file://下极易 404，应使用public/下静态资源或配置publicPath: "./" - React 使用
create-react-app时，若部署到子路径（如file:///android_asset/www/），需设homepage: "."并确保build后的asset-manifest.json路径可访问 - 关键：在框架启动前插入诊断代码，例如在
顶部加：<script>document.write('HTML loaded <br>'); console.log('DOM ready');</script>—— 若这行没输出，说明 HTML 解析被阻断（如 BOM 字符、非法 UTF-8）
白屏伴随闪退或 ANR？检查 WebView 初始化时机与线程模型
Android 上在非主线程创建 WebView、或在 Activity onDestroy() 后继续调用其方法，会导致静默崩溃或白屏冻结。
- 确保
WebView实例只在主线程创建，且生命周期与宿主 Activity 严格绑定；避免在AsyncTask或后台线程中操作 WebView - 不要复用已 detach 的 WebView：调用
removeView(webView)后未清空引用，后续loadUrl()可能无响应 - Android 9+ 默认禁用明文 HTTP 请求，若页面内含
http://资源（图片、API），会静默失败；需在AndroidManifest.xml的application标签下添加android:usesCleartextTraffic="true"（仅调试期，上线务必切 HTTPS）
真正难排查的白屏，往往卡在「什么都没报，但什么都没发生」——这时候要放弃看 JS 堆栈，转而抓取网络请求流、检查 WebView 初始化状态、验证 HTML 字节流完整性。一个被 BOM 头污染的 index.html，能在所有平台稳定白屏且不报任何错误。
