浏览器Geolocation API不触发错误且不遵守超时限制问题排查

你的代码存在一处可优化的小瑕疵，但导致Promise无限挂起的核心原因是WebKit（iOS/macOS端浏览器内核）对Geolocation API的特殊实现逻辑，并非完全是你代码的遗漏。

代码现有问题 #

你的函数入参定义了options参数，但函数内部直接重新声明了同名options对象，完全覆盖了外部传入的配置，外部自定义参数不会生效。

挂起现象的核心原因 #

Geolocation API自带的timeout参数，仅计算用户授予权限后，浏览器从传感器/网络获取位置坐标的耗时，权限等待、授权弹窗响应的时间完全不计入超时范围，这个是W3C规范明确约定的行为：

• 场景1（系统更新后权限被撤销）：此时WebKit不会立刻触发错误回调，会进入「等待用户手动修改权限配置」的状态，既不返回成功也不返回失败，完全不触发内置超时。
• 场景2（外部链接唤起iOS浏览器）：iOS 14+的隐私规则中，外部唤起的临时浏览上下文，浏览器会延迟弹出授权弹窗的时机——如果页面加载初期就调用定位接口，WebKit会将请求挂起，等用户产生交互后再弹窗，这个等待过程也不计入超时。

除此之外WebKit还有公开的已知bug：当用户在授权弹窗弹出时切后台、关闭弹窗，定位请求会永久挂起，无任何回调触发。

可落地的修复方案 #

1. 修复参数覆盖问题 #

合并外部传入的配置与默认参数，同时自实现全局兜底超时，覆盖权限等待阶段的逻辑：

export function getPosition(customOptions = {}) {
  return new Promise((resolve, reject) => {
    let fallbackTimeoutId;

    function success(pos) {
      clearTimeout(fallbackTimeoutId);
      resolve(pos);
    }

    function failure(err) {
      clearTimeout(fallbackTimeoutId);
      reject(err);
    }

    // 自实现兜底超时，覆盖权限等待阶段，避免请求永久挂起
    fallbackTimeoutId = setTimeout(() => {
      reject(new Error('定位请求超时，可能为权限未授予或授权弹窗被延迟'));
    }, 6000);

    // 合并默认配置与外部传入参数，避免覆盖入参
    const options = {
      enableHighAccuracy: true,
      timeout: 5000, // 原生超时仅负责定位阶段的超时校验
      maximumAge: 6000,
      ...customOptions
    };

    navigator.geolocation.getCurrentPosition(success, failure, options);
  });
}

2. 针对两类iOS场景的额外适配 #

• 系统权限被撤销场景：高版本iOS（17+）可以在调用定位前，先通过navigator.permissions.query({name:'geolocation'})查询权限状态，若状态为denied，直接提示用户跳转系统设置开启权限，避免请求挂起。低版本iOS无对应查询能力，完全依赖上述兜底超时处理即可。
• 外部链接唤起场景：不要在页面首屏加载阶段立刻调用定位接口，要么绑定到用户主动点击的按钮事件上触发，要么页面加载完成后延迟1-2秒再调用，避免触发WebKit的弹窗延迟机制。

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