Android WebView缺失Notification API致页面空白的解决方案咨询

问题现象 #

加载特定URL时WebView出现空白白屏，但该URL在Chrome/Chromium中可正常加载并显示Web通知。核心错误为：

I/chromium: [INFO:CONSOLE(2)] "ReferenceError: Notification is not defined"
I/chromium: [INFO:CONSOLE(1)] "Redirect.validateUserSession():Auth.userSession() err: ReferenceError: Notification is not defined"

触发点为页面中的Notification.requestPermission().then()代码，因Android WebView不支持Notification API，导致未捕获异常引发页面崩溃白屏。

可行解决方案 #

方案1：WebView端注入Notification Polyfill #

在WebView加载页面前，注入JS代码模拟Notification API，避免页面因API不存在抛出异常：

webView.setWebViewClient(new WebViewClient() {
    @Override
    public void onPageStarted(WebView view, String url, Bitmap favicon) {
        super.onPageStarted(view, url, favicon);
        // 注入模拟的Notification对象
        view.evaluateJavascript("(function() { " +
            "if (!window.Notification) { " +
            "window.Notification = { " +
            "requestPermission: () => Promise.resolve('denied'), " +
            "permission: 'denied' " +
            "}; " +
            "} " +
            "})();", null);
    }
});

说明：模拟requestPermission返回denied，页面可正常执行后续逻辑；若需要模拟授权状态，可将返回值改为granted，但WebView本身无法显示Web通知，需结合其他方案处理通知需求。

方案2：修改前端代码做兼容性判断 #

若有权限修改页面代码，在执行通知逻辑前先判断API是否存在：

if ('Notification' in window) {
    Notification.requestPermission().then(permission => {
        // 原有Web通知逻辑
    });
} else {
    // 兼容处理：提示用户使用浏览器打开，或静默跳过通知逻辑
    console.log('当前环境不支持Web通知');
}

说明：从根源避免未捕获异常，是最彻底的前端兼容方案。

方案3：使用Chrome Custom Tabs替代WebView #

若Web通知为核心需求，直接调用Chrome Custom Tabs打开URL，利用Chrome的完整Web API支持：

CustomTabsIntent.Builder builder = new CustomTabsIntent.Builder();
CustomTabsIntent customTabsIntent = builder.build();
customTabsIntent.launchUrl(context, Uri.parse("目标URL"));

说明：用户体验接近WebView，但依赖Chrome浏览器，适合对Web通知有强需求的场景。

方案4：用Android原生通知替代Web通知 #

拦截页面的通知请求，通过Android原生NotificationManager实现通知展示：

1. 原生端添加JS接口：

webView.addJavascriptInterface(new NotificationBridge(), "AndroidNotification");

public class NotificationBridge {
    @JavascriptInterface
    public void showNotification(String title, String content) {
        // 需提前创建通知渠道（Android 8.0+要求）
        NotificationCompat.Builder builder = new NotificationCompat.Builder(context, "NOTIFICATION_CHANNEL_ID")
                .setSmallIcon(R.drawable.ic_notification)
                .setContentTitle(title)
                .setContentText(content)
                .setPriority(NotificationCompat.PRIORITY_DEFAULT);

        NotificationManagerCompat.from(context).notify(System.currentTimeMillis(), builder.build());
    }
}

2. 前端调用原生接口：

if (!('Notification' in window) && window.AndroidNotification) {
    // 调用原生通知替代Web通知
    window.AndroidNotification.showNotification("通知标题", "通知内容");
}

说明：实现Web通知的原生替代，兼顾页面功能完整性与原生系统的通知体验。

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