本文详解 flutter 中使用 flutter_inappwebview 加载 https 网页时 geolocation api 报错“user denied the request for geolocation”的根本原因及专业级修复方案，涵盖 android 权限回调配置、https 安全要求与代码最佳实践。
本文详解 flutter 中使用 flutter_inappwebview 加载 https 网页时 geolocation api 报错“user denied the request for geolocation”的根本原因及专业级修复方案，涵盖 android 权限回调配置、https 安全要求与代码最佳实践。
在 Flutter 应用中集成 flutter_inappwebview 加载外部网页并调用浏览器原生 Geolocation API 是常见需求。但开发者常遇到一个典型问题：同一段 JavaScript 地理位置代码，在 w3schools 示例页上正常工作，却在自己的 HTTPS 网页中持续触发 PERMISSION_DENIED 错误（即使用户从未点击拒绝）。这并非前端逻辑错误，而是 InAppWebView 在 Android 平台对地理位置权限的生命周期管理未被显式处理所致。
根本原因分析
Android 系统要求：当 WebView 内网页调用 navigator.geolocation.getCurrentPosition() 时，系统会向 WebView 发起地理定位权限授权请求（Geolocation Permissions Prompt）。而 flutter_inappwebview 默认不会自动响应该请求——它既不弹窗提示用户，也不默认授予权限，导致请求超时或静默失败，最终 JavaScript 的 error.code === error.PERMISSION_DENIED 被触发。
值得注意的是：
- ✅ geolocationEnabled: true 仅启用 WebView 的地理定位能力，不等于自动授权；
- ✅ Permission.location.request() 是对 Flutter 应用自身的原生位置权限申请，不影响 WebView 内部的网页权限流；
- ✅ HTTPS 是硬性前提（Chrome/Android 要求 getCurrentPosition() 必须在安全上下文中运行），你的网页已满足此条件，故非主因；
- ❌ 缺失 androidOnGeolocationPermissionsShowPrompt 回调是导致该问题的直接技术原因。
正确解决方案（Android 专属）
需在 InAppWebView 实例中显式实现两个关键回调，主动接管权限决策：
InAppWebView(
initialUrlRequest: URLRequest(
url: Uri.parse('https://your-secure-site.com/geolocation-page.html'),
),
// 【核心】响应地理定位权限弹窗请求
androidOnGeolocationPermissionsShowPrompt:
(controller, origin) async {
// origin 是发起请求的网页域名（如 https://your-secure-site.com）
return GeolocationPermissionShowPromptResponse(
origin: origin,
allow: true, // 明确允许地理位置访问
retain: true, // 保留授权状态（避免重复请求）
);
},
// 【增强】响应其他权限请求（如摄像头、麦克风等，可选但推荐）
androidOnPermissionRequest:
(controller, origin, resources) async {
return PermissionRequestResponse(
resources: resources,
action: PermissionRequestResponseAction.GRANT,
);
},
initialOptions: InAppWebViewGroupOptions(
android: AndroidInAppWebViewOptions(
useWideViewPort: true,
geolocationEnabled: true, // 保持启用
// 注意：无需设置 databasePath（新版插件已自动处理）
),
ios: IOSInAppWebViewOptions(
allowsInlineMediaPlayback: true,
// iOS 下地理定位通常自动工作，但需确保 WKWebView 配置正确（见下方说明）
),
),
)iOS 补充说明
iOS 平台行为略有不同：
- navigator.geolocation 在 WKWebView（flutter_inappwebview iOS 底层）中默认受 Safari 策略约束；
- 必须确保你的网页部署在 HTTPS 域名下（你已满足）；
- 若仍失败，请检查 Info.plist 是否添加了以下隐私描述（虽非强制，但 Apple 审核可能要求）：
<key>NSLocationWhenInUseUsageDescription</key> <string>此应用需要访问您的位置以提供基于位置的服务。</string>
- iOS 无需像 Android 那样手动实现 geolocationPermissions 回调，但建议保留 allowsInlineMediaPlayback: true 提升兼容性。
完整最佳实践清单
✅ 必须项
- AndroidManifest.xml 中声明位置权限（你已完成）；
- androidOnGeolocationPermissionsShowPrompt 回调返回 allow: true；
- 网页 URL 使用 HTTPS（不可用 HTTP 或 localhost）；
- Flutter 端 Permission.location.request() 用于 App 自身功能（如后台定位），与 WebView 权限解耦。
⚠️ 建议项
- 添加 androidOnPermissionRequest 统一授权媒体类权限；
- 在 InAppWebView 的 onLoadStop 中注入调试脚本，验证 navigator.geolocation 是否可用：
onLoadStop: (controller, url) async { await controller.evaluateJavascript(source: ''' console.log('Geolocation available:', !!navigator.geolocation); console.log('Origin:', document.location.origin); '''); }
❌ 常见误区
- 误以为 geolocationEnabled: true 即代表权限已授；
- 在 onLoadStart 中调用 controller.evaluateJavascript(... navigator.geolocation ...) —— 此时页面 JS 尚未执行，结果不可靠；
- 忽略 retain: true 导致每次刷新页面都重新触发权限请求。
总结
“User denied the request for Geolocation” 这一错误信息具有误导性——它实际反映的是 WebView 未收到任何授权响应，而非用户主动拒绝。通过显式实现 androidOnGeolocationPermissionsShowPrompt 回调并返回 allow: true，即可让 Android WebView 正确响应地理定位权限请求，彻底解决该问题。该方案简洁、稳定，且符合 Android 平台 WebView 权限模型的设计规范。
