悟空浏览器白屏可尝试五种独立修复方法：一、禁用扩展后硬刷；二、注销Service Worker并清除缓存与Cookie；三、通过chrome://flags禁用PreferredOmniboxPopupDirection后重启；四、关闭硬件加速、检查chrome://gpu状态并结束GPU进程；五、清理启动参数、设主页为about:blank并重置Preferences文件。
如果您在使用悟空浏览器访问网页时出现白屏现象，页面内容无法正常渲染，则可能是由于资源加载失败、JavaScript 执行异常或渲染引擎异常导致。以下是多种可独立尝试的修复方法：
一、强制刷新并禁用扩展
浏览器扩展可能劫持页面资源或干扰 DOM 渲染，导致白屏。临时禁用所有扩展后重新加载，可排除第三方脚本干扰。
1、点击悟空浏览器右上角“≡”菜单按钮，选择“扩展管理”。
2、将所有已启用的扩展开关切换为关闭状态。
3、打开发生白屏的网页，按 Ctrl + F5（Windows）或 Cmd + Shift + R（macOS）执行硬性刷新。
二、清除网页专属缓存与服务工作器
损坏的 Service Worker 或过期的静态资源缓存会阻止页面初始化，尤其影响单页应用（SPA）的首屏渲染。
1、在白屏页面地址栏输入 chrome://serviceworker-internals/（悟空浏览器基于 Chromium 内核，支持该调试页）。
2、查找对应域名的服务工作器条目，点击右侧“Unregister”按钮解除注册。
3、返回原网页，进入“设置 → 隐私与安全 → 清除浏览数据”，勾选“缓存的图片和文件”“Cookie 及其他网站数据”，时间范围选“所有时间”，点击“清除数据”。
三、切换渲染引擎模式
悟空浏览器支持切换 Blink 渲染内核的行为策略，部分网页在默认渲染模式下因 CSS containment 或 iframe sandbox 策略触发白屏，切换兼容模式可绕过限制。
1、在地址栏输入 chrome://flags/#enable-blink-features 并回车。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
2、在搜索框中输入 PreferredOmniboxPopupDirection，找到后将其设为 Disabled（此项可间接重置渲染上下文初始化逻辑）。
3、重启浏览器后再次访问该网页。
四、禁用硬件加速并重置 GPU 进程
GPU 渲染进程崩溃或驱动不兼容会导致页面布局树构建失败，表现为纯白背景无任何元素输出，控制台常伴随 Failed to allocate GPU memory 类错误。
1、进入“设置 → 系统”，关闭“使用硬件加速模式（如果可用）”选项。
2、在地址栏输入 chrome://gpu/，确认“Graphics Feature Status”中各项状态均为 Hardware accelerated 以外的提示（如 Software only）。
3、关闭所有悟空浏览器窗口，在任务管理器中结束所有名为 WukongBrowser.exe 和 GPU Process 的进程。
五、重置浏览器主页与启动参数
被篡改的启动参数（如 --disable-web-security 或 --unsafely-treat-insecure-origin-as-secure）可能导致跨域资源拦截失败，进而触发空白渲染。
1、右键悟空浏览器快捷方式 → “属性”，查看“目标”字段末尾是否含异常参数；若有，删除全部双引号外的参数，仅保留路径。
2、进入“设置 → 启动时”，选择“打开特定网页或一组网页”，点击“添加新网页”，输入 about:blank，移除其他所有启动页。
3、关闭浏览器，手动删除用户数据目录下的 Preferences 文件（路径通常为：%LOCALAPPDATA%\WukongBrowser\User Data\Default\Preferences），重启后生成全新配置。
