如何让Android模拟器中的WebView指向本地localhost服务？

一、解决WebView跳转外部浏览器问题 #

默认情况下，WebView遇到未处理的URL会调用系统浏览器打开，必须自定义WebViewClient拦截加载行为：

1. 在初始化WebView的代码中添加以下配置：

WebView webView = findViewById(R.id.your_webview_id);
webView.setWebViewClient(new WebViewClient() {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        // 让WebView自行处理URL加载，不跳转外部浏览器
        view.loadUrl(request.getUrl().toString());
        return true;
    }

    // 兼容Android 7以下版本
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        view.loadUrl(url);
        return true;
    }
});

2. 排查代码中是否存在强制启动外部浏览器的逻辑，避免冲突。

二、解决ERR_CONNECTION_REFUSED连接拒绝问题 #

1. 确认本地服务监听地址 #

你的本地Web应用不能仅绑定127.0.0.1（localhost），必须绑定0.0.0.0允许所有网卡访问：

• 启动本地服务时指定监听地址为0.0.0.0:8001（不同开发工具的配置方式：React/Vue可加--host 0.0.0.0，Node.js服务设置server.listen(8001, '0.0.0.0')）
• 验证：宿主机浏览器访问http://0.0.0.0:8001能正常打开后，再用模拟器访问http://10.0.2.2:8001

2. 适配Android 9+明文HTTP限制 #

如果本地服务是HTTP协议，Android 9及以上默认禁止明文流量，需做如下配置：

• 在AndroidManifest.xml的application标签中添加：

android:usesCleartextTraffic="true"

• 或创建res/xml/network_security_config.xml，仅允许指定域名的明文流量：

<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">10.0.2.2</domain>
    </domain-config>
</network-security-config>

然后在AndroidManifest.xml的application标签中引用：

android:networkSecurityConfig="@xml/network_security_config"

3. 检查网络权限 #

确保AndroidManifest.xml中已添加网络权限：

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

4. 模拟器网络适配 #

• Android Studio自带模拟器使用10.0.2.2作为宿主机映射地址；
• 第三方模拟器（如夜神、蓝叠）需使用专属宿主机IP（如夜神用172.17.0.1），可在模拟器浏览器中测试不同IP确认。

三、定位API调试额外提示 #

解决WebView加载问题后，调试定位API还需注意：

• 在AndroidManifest.xml添加定位权限：

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

• 在WebView中启用JavaScript和定位权限：

WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true);
webSettings.setGeolocationEnabled(true);
// 处理定位权限请求
webView.setWebChromeClient(new WebChromeClient() {
    @Override
    public void onGeolocationPermissionsShowPrompt(String origin, GeolocationPermissions.Callback callback) {
        callback.invoke(origin, true, false);
    }
});

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