特定链接https://app.seesaw.me/#/login在Android Webview中无法渲染问题

云上老周

2026-9-28

问题根因

白屏的核心诱因是Logcat中输出的Uncaught TypeError: Cannot read properties of null (reading 'getItem')错误：

该错误是前端JS尝试调用localStorage/sessionStorage的getItem方法时，获取到的存储对象为null，是WebView默认未开启DOM存储权限导致的
seesaw登录页依赖本地存储存储临时页面数据、登录态相关信息，JS抛出未捕获异常后后续渲染逻辑中断，直接出现白屏
其余两条日志属于前端兼容性警告，不会阻断页面渲染，无需额外处理

修复步骤

1. 补充WebView基础配置

在现有webView.settings配置块中新增DOM存储相关配置即可：

with(webView.settings) {
    // 原有配置保留
    mixedContentMode = WebSettings.MIXED_CONTENT_ALWAYS_ALLOW
    loadsImagesAutomatically = true
    javaScriptEnabled = true
    ResourcesCompat.getFont(requireContext(), R.font.helvetica_neue)

    // 新增必填配置
    domStorageEnabled = true // 开启DOM存储，解决localStorage为null的核心问题
    databaseEnabled = true // 兼容依赖WebSQL的前端逻辑
    userAgentString = settings.userAgentString.replace("; wv", "") // 移除WebView专属UA标记，避免站点做兼容性拦截
}

2. 可选补充配置

如果添加上述配置后仍有异常，可补充WebView客户端配置，避免跳转系统浏览器、方便后续问题排查：

// 禁止页面跳转时调用系统默认浏览器
webView.webViewClient = WebViewClient()

// 配置Chrome客户端接收JS日志、支持JS弹窗
webView.webChromeClient = object : WebChromeClient() {
    override fun onConsoleMessage(consoleMessage: ConsoleMessage?): Boolean {
        Log.d("WebViewConsole", "${consoleMessage?.message()} | 行号：${consoleMessage?.lineNumber()} | 来源：${consoleMessage?.sourceId()}")
        return super.onConsoleMessage(consoleMessage)
    }
}