KsuWebUI 中文文档 下载 App

WebView 加载失败——界面白屏或提示初始化错误

症状

打开 KsuWebUI 后出现以下任一情况：

排查清单

检查一：WebView 是否安装并启用

设置 → 应用 → 显示系统应用 → Android System WebView

检查二：Chrome 是否可用

某些 ROM 把 WebView 集成在 Chrome 浏览器里。确认 Chrome 已安装且能正常打开网页。

检查三：端口是否被占用

用终端检查 KsuWebUI 默认端口：

su
netstat -tlnp | grep 8080

如果有其他进程占用了 8080，要么关掉占用进程，要么在 KsuWebUI 设置里换端口。

检查四：重启手机

重启能解决 80% 的初始化问题。如果只是 WebView 和 root 框架之间的通信出了问题，重启会重新初始化所有组件。

检查五：清理 KsuWebUI 缓存

设置 → 应用 → KsuWebUI → 存储 → 清理缓存

仍然不行怎么办

重装 KsuWebUI

  1. 卸载当前版本的 KsuWebUI
  2. 清理残留数据（应用设置里点「清除数据」）
  3. 重新下载安装最新版 KsuWebUI
  4. 首次启动时注意 root 框架的授权弹窗

换浏览器访问（临时方案）

如果 APP 内的 WebView 始终不行，但 KsuWebUI 的本地服务已经启动成功（能看到端口地址）：

  1. 复制本地地址（如 http://127.0.0.1:8080）
  2. 打开手机上的 Chrome 浏览器
  3. 粘贴地址访问

Chrome 本身也是基于 WebView 的，只是渲染效果可能略有不同。如果 Chrome 里能正常显示，说明 KsuWebUI 的 Web 服务本身没问题，问题出在 APP 内的 WebView 容器上。

检查 root 框架兼容性

某些极老版本的 KernelSU 或 Magisk 可能和最新版 KsuWebUI 不兼容。检查 KsuWebUI 的发布说明，看它要求的最低框架版本。

定制 ROM 特别注意

部分 ROM（尤其是国产定制）可能对 WebView 做了修改或禁用：