navigator.geolocation 返回 undefined 或报错主因是环境不合规：非 HTTPS（除 localhost）、iframe 未设 allow="geolocation"、用户已拒权、或非用户手势触发；正确调用须由点击等交互触发，并处理成功与各类错误响应。
浏览器里调用 navigator.geolocation 获取用户位置，前提是用户授权且环境满足安全要求（HTTPS 或 localhost）；否则直接拒绝或静默失败。
为什么 navigator.geolocation 会返回 undefined 或报错
常见原因不是代码写错，而是运行环境不合规：
- 页面未通过 HTTPS 提供（除
localhost外，现代浏览器一律禁用） - 在 iframe 中调用但未设置
allow="geolocation"属性 - 用户已永久拒绝地理位置权限，且未在浏览器设置中重置
- 某些浏览器（如 Safari 移动端）对非用户手势触发的获取行为直接忽略（比如页面加载时自动调用
getCurrentPosition）
如何正确调用 getCurrentPosition 并处理响应
必须由用户显式交互（如点击按钮）触发，且需同时处理成功与失败路径：
document.getElementById('get-location-btn').addEventListener('click', () => {
if (!navigator.geolocation) {
console.error('浏览器不支持 Geolocation API');
return;
}
navigator.geolocation.getCurrentPosition(
(position) => {
const { latitude, longitude } = position.coords;
console.log('纬度:', latitude, '经度:', longitude);
},
(error) => {
switch (error.code) {
case error.PERMISSION_DENIED:
console.error('用户拒绝了地理位置请求');
break;
case error.POSITION_UNAVAILABLE:
console.error('位置信息不可用');
break;
case error.TIMEOUT:
console.error('请求超时');
break;
default:
console.error('未知错误:', error.message);
}
},
{
enableHighAccuracy: false, // 是否启用高精度（耗电/慢），默认 false
timeout: 5000, // 毫秒，超过此时间触发 error.TIMEOUT
maximumAge: 60000 // 允许返回缓存位置的最大毫秒数（1分钟内有效）
}
);
});
为什么 watchPosition 不该长期开着
它会持续监听位置变化，带来明显性能和电量开销，且不同平台行为不一致：
立即学习“Java免费学习笔记（深入）”；
- Android Chrome 可能每几秒触发一次更新，即使用户静止
- iOS Safari 对后台页面会大幅降低更新频率甚至暂停
- 没配
clearWatch容易造成内存泄漏或重复回调 - 权限提示只出现一次，后续无法重新触发授权 UI，出错后只能引导用户手动改设置
实际使用建议：仅在导航、签到等明确需要连续定位的场景开启，并在任务结束时立即调用 navigator.geolocation.clearWatch(watchId)。
真正麻烦的从来不是怎么写那几行 JS，而是权限状态不可控、设备 GPS 模块响应延迟、Wi-Fi 定位不准却优先返回、以及 iOS 上“仅在使用期间允许”选项导致后台定位失效这些隐性约束。
