iOS上HTML5定位失败根本原因是系统限制：必须HTTPS、用户手势触发、安全上下文三者同时满足，否则静默拒绝并返回error.code=1。
为什么 iOS 上 HTML5 navigator.geolocation 一直提示“拒绝”或返回 error.code = 1
根本原因不是 HTML 代码写错了，而是 iOS 系统层面对 Web 页面的定位权限做了严格限制：Safari（以及所有 WKWebView）**默认不向非 HTTPS、非用户主动触发、或非“安全上下文”下的页面授予地理定位权限**。即使你写了 navigator.geolocation.getCurrentPosition()，iOS 也会静默拒绝或直接抛出 PermissionDeniedError（error.code === 1）。
常见诱因包括：
- 页面通过
http://（非 HTTPS）加载 —— iOS 10+ 强制要求定位 API 必须运行在安全上下文（HTTPS 或localhost） - 调用
getCurrentPosition()发生在页面加载完成前，或由定时器/后台逻辑自动触发，而非用户点击等明确手势事件（如click、touchend） - WKWebView 中未启用定位能力（原生侧未配置），或用户已在系统设置中全局关闭 Safari 定位权限
如何让 iOS Safari 正确弹出定位授权对话框
必须同时满足三个条件，缺一不可：
- 网页必须通过
https://协议访问（自签名证书不行；http://localhost在本地调试时可临时允许） - 调用
navigator.geolocation.getCurrentPosition()必须发生在用户手势事件回调内（例如：button.addEventListener('click', () => { ... })），不能放在DOMContentLoaded或setTimeout里 - 确保用户未在「设置 → Safari → 定位服务」中将 Safari 设为“永不”或“拒绝”；若已关闭，需手动打开并设为“询问”或“允许”
示例正确写法：
立即学习“前端免费学习笔记（深入）”；
WKWebView 中 HTML5 定位失效的排查重点
如果你的 HTML 页面嵌在 iOS 原生 App 的 WKWebView 里，光靠前端 JS 不够，原生侧必须显式开启定位支持：
- Info.plist 中必须添加
NSLocationWhenInUseUsageDescription键，并填写用户可见的用途说明（否则系统直接拦截） - App 启动后需调用
[CLLocationManager requestWhenInUseAuthorization]主动申请权限（仅声明描述符不够） -
WKWebViewConfiguration需设置websiteDataStore = .nonPersistent()（iOS 13+ 推荐），且确保未禁用geolocation相关策略（默认是开启的） - 注意：WKWebView 默认不继承 Safari 的定位授权状态，它走的是独立的 App 级权限体系
常见错误响应及对应处理方式
遇到 navigator.geolocation 返回错误时，不要只打印 err.message，应检查 err.code 并分情况处理：
-
err.code === 1（PERMISSION_DENIED）：用户拒绝 / 系统未授权 → 引导用户去「设置 → [你的App 或 Safari] → 定位服务」手动开启 -
err.code === 2（POSITION_UNAVAILABLE）：GPS 信号弱、飞行模式、或设备无定位模块 → 提示“请检查网络与定位开关” -
err.code === 3（TIMEOUT）：默认超时 10s，可传入{ timeout: 15000 }延长；但 iOS 下过长等待仍可能被系统中断 - 始终补充
enableHighAccuracy: false（默认为false），避免在 iOS 上因强制高精度触发额外权限校验失败
权限状态无法通过 JS 直接读取（navigator.permissions.query({name:'geolocation'}) 在 iOS Safari 中多数版本返回 prompt 即使已拒绝），所以实际体验中，首次调用就是唯一可靠的触发时机。
