Android WebView调用getCurrentPosition获取地理位置时权限报错

阿华AIGC实验室

2026-5-25

解决Android WebView中getCurrentPosition权限报错问题

这个问题我碰到过不少次——WebView和Chrome的权限体系不一样，Chrome作为独立浏览器自带完整的权限处理逻辑，而WebView完全依赖你的Android宿主应用来配置权限，下面一步步帮你解决：

1. 确保Manifest中声明了必要的位置权限

首先检查你的AndroidManifest.xml，必须添加位置权限声明，否则系统根本不会给应用授权：

<!-- 精确位置权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- 粗略位置权限 -->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

<!-- 注意：如果你的应用目标API是29（Android 10）及以上，且需要后台持续定位才需要下面这个权限，普通前台定位不需要 -->
<!-- <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> -->

2. 动态申请位置权限（API 23+必备）

Android 6.0（API级别23）及以上，危险权限（比如位置权限）不能只靠Manifest声明，还需要在运行时向用户申请。你需要在宿主Activity中添加权限申请逻辑：

private static final int REQUEST_LOCATION_PERM = 101;

// 在初始化WebView前先检查权限
private void prepareLocationPermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION)
            != PackageManager.PERMISSION_GRANTED) {
        // 权限未授予，发起申请
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                REQUEST_LOCATION_PERM);
    } else {
        // 权限已就绪，初始化WebView
        setupWebView();
    }
}

// 处理权限申请结果
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_LOCATION_PERM) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 用户同意权限，初始化WebView
            setupWebView();
        } else {
            // 用户拒绝权限，这里可以给个提示
            Toast.makeText(this, "需要位置权限才能获取你的地理位置", Toast.LENGTH_SHORT).show();
        }
    }
}

3. 配置WebView的设置并处理Web层权限请求

光有原生权限还不够，WebView本身需要开启地理位置支持，并且处理JS层面的权限请求：

private void setupWebView() {
    WebView webView = findViewById(R.id.your_webview_id);
    WebSettings webSettings = webView.getSettings();
    
    // 必须开启JavaScript，因为getCurrentPosition是JS API
    webSettings.setJavaScriptEnabled(true);
    // 开启WebView的地理位置支持
    webSettings.setGeolocationEnabled(true);
    
    // 设置WebChromeClient，处理JS发起的地理位置权限请求
    webView.setWebChromeClient(new WebChromeClient() {
        @Override
        public void onGeolocationPermissionsShowPrompt(String origin, GeolocationPermissions.Callback callback) {
            // 这里直接允许该域名的地理位置请求，也可以弹框让用户二次确认
            callback.invoke(origin, true, false);
        }
    });
    
    // 加载你的网页
    webView.loadUrl("https://your-web-page.com");
}