Android WebView无法识别JavaScript、崩溃及Google服务影响问题咨询

我开发了一款小型应用，使用WebView的核心代码如下：

public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
    View v = inflater.inflate(R.layout.fragment_photo_page, container, false);
    mWebView = v.findViewById(R.id.web_view);
    WebSettings webSettings = mWebView.getSettings();
    webSettings.setJavaScriptEnabled(true);
    mWebView.setWebViewClient(new WebViewClient());
    mWebView.loadUrl(mUri.toString());

    return v;
}

测试结果（所有测试基于Nexus 5X）：

• API 22/23：无论是否有Google服务，WebView可运行但JavaScript均不生效
• API 24/25：有Google服务时正常；无Google服务时WebView可运行，但JavaScript不生效
• API 26：有Google服务时正常；无Google服务时加载WebView直接崩溃，日志提示Chromium WebView package does not exist及MissingWebViewPackageException
• API 27及以上：无论是否有Google服务，WebView均能正常识别JavaScript

针对JavaScript不生效的问题，我尝试添加以下配置但未解决：

webSettings.setDomStorageEnabled(true);
webSettings.setLoadWithOverviewMode(true);
webSettings.setUseWideViewPort(true);
webSettings.setBuiltInZoomControls(true);
webSettings.setDisplayZoomControls(false);
webSettings.setSupportZoom(true);
webSettings.setDefaultTextEncodingName("utf-8");
mWebView.setWebChromeClient(new WebChromeClient());

现咨询以下问题：

1. Google服务如何影响WebView对JavaScript的支持？
2. API26设备为何无法加载WebView？WebView属于Android系统组件，理应可正常加载？
3. 如何正确使用WebView，使其在所有API版本下均可正常识别JavaScript且不崩溃？

1. Google服务对WebView JavaScript支持的影响 #

在API 24-26阶段，Android WebView存在双实现机制：

• 有Google服务的设备：默认使用Google Play服务提供的Chrome WebView——这是独立更新的组件，对JavaScript语法（包括ES6+）支持完整，引擎稳定性高，所以能正常运行JS代码。
• 无Google服务的设备：使用系统内置的WebView实现，部分原生系统或厂商定制系统会裁剪WebView功能，比如简化JavaScript引擎、关闭部分语法支持，甚至存在JS引擎启用失败的底层bug，导致开启setJavaScriptEnabled(true)后仍无法生效。

API 27及之后，Android统一了WebView的实现标准，系统内置WebView与Chrome WebView的功能完全对齐，不再依赖Google服务提供额外支持，所以无Google服务的设备也能正常运行JS。

2. API 26设备无Google服务时WebView崩溃的原因 #

API 26是Android WebView架构切换的过渡版本：

• 该版本系统默认优先调用Google Play服务提供的Chrome WebView组件，而非传统的系统内置WebView
• 当设备无Google服务时，Chrome WebView包不存在，而系统未做自动 fallback 到内置WebView的处理，直接抛出MissingWebViewPackageException导致崩溃。
• 这个是过渡阶段的系统设计缺陷，API 27中已修复，系统会自动检测WebView组件可用性，自动切换到可用的实现。

3. 跨API版本WebView的正确使用方案 #

一、完善核心配置 #

在原有配置基础上，补充针对低版本的兼容设置：

WebSettings webSettings = mWebView.getSettings();
webSettings.setJavaScriptEnabled(true);
// 启用DOM存储，部分JS框架依赖此特性
webSettings.setDomStorageEnabled(true);
// 针对API <24设备，强制启用JS引擎兼容模式
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) {
    webSettings.setJavaScriptCanOpenWindowsAutomatically(true);
    // 部分低版本WebView需要开启插件支持才能正常运行JS
    webSettings.setPluginState(WebSettings.PluginState.ON);
}
// 开启调试（可选，便于排查低版本JS失效问题）
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    WebView.setWebContentsDebuggingEnabled(true);
}

二、修复API 26崩溃问题 #

在初始化WebView前添加异常捕获与 fallback 逻辑：

try {
    mWebView = v.findViewById(R.id.web_view);
} catch (MissingWebViewPackageException e) {
    if (Build.VERSION.SDK_INT == Build.VERSION_CODES.O) {
        // 强制切换到系统内置WebView
        WebViewFactory.setWebViewPackageName("com.android.webview");
        mWebView = new WebView(requireContext());
        // 手动将WebView添加到布局
        ((ViewGroup)v).addView(mWebView, new ViewGroup.LayoutParams(
            ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.MATCH_PARENT
        ));
    }
}

三、页面兼容性优化 #

• 确保加载的HTML页面使用ES5兼容的JavaScript语法，避免使用低版本WebView不支持的ES6+特性（如箭头函数、let/const等），如需使用可引入polyfill库做兼容
• 页面添加视口适配标签：<meta name="viewport" content="width=device-width, initial-scale=1.0">，避免WebView布局异常影响JS执行
• 避免使用依赖现代浏览器API的功能，比如fetch，可替换为XMLHttpRequest或引入兼容库

四、清单配置补充 #

在AndroidManifest.xml中添加必要权限：

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

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