Android WebView应用启动页后显示白屏问题求助

1. 先确认核心权限配置 #

在AndroidManifest.xml中必须添加网络权限，否则WebView无法加载网页：

<uses-permission android:name="android.permission.INTERNET" />

<!-- 若加载HTTP明文链接（Android 9+），需开启明文流量支持 -->
<application
    ...
    android:usesCleartextTraffic="true">
    ...
</application>

2. 检查WebView布局是否正确 #

确保WebView的宽高设置为match_parent，避免因布局尺寸为0导致白屏：

<!-- activity_main.xml -->
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <WebView
        android:id="@+id/webView"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</LinearLayout>

3. 规范WebView初始化与加载逻辑 #

以下是标准的WebView配置代码，覆盖常见加载所需的设置：

// MainActivity.kt
import android.os.Bundle
import android.webkit.WebView
import android.webkit.WebViewClient
import androidx.appcompat.app.AppCompatActivity

class MainActivity : AppCompatActivity() {
    private lateinit var webView: WebView

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        webView = findViewById(R.id.webView)
        setupWebViewSettings()
        loadTargetUrl()
    }

    private fun setupWebViewSettings() {
        webView.settings.apply {
            // 启用JavaScript（多数现代网页依赖此）
            javaScriptEnabled = true
            // 开启DOM存储，适配需要本地存储的网页
            domStorageEnabled = true
            // 允许缩放（可选）
            setSupportZoom(true)
            builtInZoomControls = true
            displayZoomControls = false
        }

        // 设置WebViewClient，避免跳转到系统浏览器
        webView.webViewClient = object : WebViewClient() {
            // 可选：监听加载状态，方便调试
            override fun onPageFinished(view: WebView?, url: String?) {
                super.onPageFinished(view, url)
                // 可在此添加加载完成后的回调，比如隐藏加载动画
            }
        }
    }

    private fun loadTargetUrl() {
        // 替换为你需要加载的网页链接
        val targetUrl = "https://example.com"
        webView.loadUrl(targetUrl)
    }

    // 处理返回键，让WebView返回上一页而非退出应用
    override fun onBackPressed() {
        if (webView.canGoBack()) {
            webView.goBack()
        } else {
            super.onBackPressed()
        }
    }
}

4. 验证闪屏页跳转逻辑 #

确保闪屏页跳转后正确销毁自身，且启动的是WebView所在的Activity：

// SplashActivity.kt
import android.content.Intent
import android.os.Bundle
import android.os.Handler
import android.os.Looper
import androidx.appcompat.app.AppCompatActivity

class SplashActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_splash)

        // 延迟2秒跳转，可根据需求调整时长
        Handler(Looper.getMainLooper()).postDelayed({
            val intent = Intent(this, MainActivity::class.java)
            startActivity(intent)
            finish() // 销毁闪屏页，避免返回键回到闪屏
        }, 2000)
    }
}

5. 调试排查技巧 #

• 直接将MainActivity设为启动页，测试WebView能否正常加载，排除闪屏页干扰。
• 查看Logcat的WebView相关日志，搜索WebView、Network关键词，定位加载失败原因。
• 尝试加载本地测试页面（如file:///android_asset/test.html），验证WebView本身是否正常工作。

内容的提问来源于stack exchange，提问作者El Denyello