Android WebView位置权限弹窗不显示的问题求助

核心问题分析 #

WebView加载HTTPS网站时，无法触发地理定位权限请求弹窗，onGeolocationPermissionsShowPrompt方法未被调用，导致网站JS抛出Uncaught (in promise) TypeError: Cannot read property 'query' of undefined错误。

修复步骤 #

1. 确保APP已申请位置权限 #

WebView的地理定位依赖宿主APP的位置权限，需完成以下操作：

• 在AndroidManifest.xml中声明权限：

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

• Android 6.0（API 23）及以上版本，需动态申请权限，不能仅依赖Manifest声明。

2. 修正onGeolocationPermissionsShowPrompt方法的重写 #

自定义WebChromeClient中该方法未添加@Override注解，可能因方法签名不匹配导致系统无法正确调用。必须添加注解确保重写父类方法：

public class CustomChromeClient extends WebChromeClient {

    private Callback mGeolocationCallback;
    private String mGeolocationOrigin;

    @Override // 关键：必须添加该注解
    public void onGeolocationPermissionsShowPrompt(String origin, Callback callback) {
        // 先检查APP是否已获取位置权限
        if (ContextCompat.checkSelfPermission(getApplicationContext(), Manifest.permission.ACCESS_FINE_LOCATION)
                != PackageManager.PERMISSION_GRANTED) {
            // 动态申请权限
            ActivityCompat.requestPermissions(YourActivity.this,
                    new String[]{Manifest.permission.ACCESS_FINE_LOCATION},
                    1001); // 自定义请求码
            mGeolocationCallback = callback;
            mGeolocationOrigin = origin;
        } else {
            // 已有权限，直接允许网站获取位置
            callback.invoke(origin, true, false);
            Log.d("HIDDEO", "Ejemplo");
        }
    }

    // 其他方法保持不变...
}

3. 处理权限申请结果 #

在宿主Activity中重写onRequestPermissionsResult，根据用户的权限选择处理回调：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == 1001) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限通过，执行定位授权
            if (mGeolocationCallback != null) {
                mGeolocationCallback.invoke(mGeolocationOrigin, true, false);
            }
        } else {
            // 权限拒绝，告知网站无法获取位置
            if (mGeolocationCallback != null) {
                mGeolocationCallback.invoke(mGeolocationOrigin, false, false);
            }
        }
    }
}

4. 补充WebView地理定位数据库路径配置 #

添加数据库路径设置，确保WebView能正常存储定位相关数据：

WebSettings settings = webViewClub.getSettings();
// 原有配置...
settings.setGeolocationDatabasePath(getApplicationContext().getFilesDir().getPath()); // 新增该行

5. 检查网站JS的定位调用逻辑 #

HTTPS环境下，现代浏览器要求定位请求必须由用户交互触发（如点击按钮），不能自动执行。需确保网站的JS代码是在用户操作后调用navigator.geolocation.getCurrentPosition或watchPosition。

关于JS错误的说明 #

Uncaught (in promise) TypeError: Cannot read property 'query' of undefined是网站JS在定位失败后未正确处理错误导致的连锁问题。修复WebView的权限请求流程后，若网站能正常获取位置，该错误会自动消失；若仍存在，需网站端补充定位失败的异常处理逻辑。

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