企业官网建设流程全解析

1. 项目概述：为什么“获取位置”是微信小程序的必修课

做微信小程序开发，尤其是涉及到本地生活、出行导航、社交分享或者任何需要基于地理位置提供服务时，“获取用户位置权限”几乎是绕不开的第一道坎。这听起来简单，不就是弹个窗让用户点个“允许”吗？但实际干过就知道，这里面的坑一个接一个。用户第一次打开，弹窗被拒绝怎么办？用户之前拒绝了，第二次怎么优雅地引导？在安卓和iOS不同机型上，授权弹窗的样式和逻辑有差异怎么处理？更头疼的是，用户明明点了允许，但手机的系统定位服务没开，或者微信自身的定位权限被关了，这时候你调API，返回的错误码可能让你一头雾水。

最近在折腾一个地图相关的小程序项目，就深刻体会到了这一点。从最初的简单调用wx.getLocation，到后来处理各种边界情况和异常流，整个过程就是一部与用户和设备权限“斗智斗勇”的血泪史。今天，我就把自己趟过的路、踩过的坑，以及总结出来的一套相对稳健的权限获取与处理方案，完整地分享出来。无论你是刚入门的小程序开发者，还是正在为线上应用的授权率发愁，希望这些实战经验都能给你带来直接的帮助。

2. 权限体系核心解析：不只是小程序层面的那点事

很多人以为在小程序里获取位置，就只是处理小程序自己的授权弹窗。这个理解太片面了，实际上，用户的位置信息能否成功获取，取决于一个三层“漏斗型”的权限体系。任何一层被关闭，你的调用都会失败。

2.1 三层权限漏斗模型

第一层，是手机操作系统的定位服务总开关。在iOS的设置-隐私与安全性-定位服务里，在安卓的设置-位置信息里。这个开关如果关了，整个手机所有App都无法使用GPS、基站或Wi-Fi进行定位。小程序作为寄生在微信内的应用，自然也拿不到任何位置数据。这是最底层的限制。

第二层，是微信App本身的定位权限。用户需要授权微信可以使用手机的位置信息。这个权限在手机系统的应用权限管理里设置。如果用户只给了微信“仅在使用期间”访问位置的权限，那么当微信退到后台，或者手机锁屏后，小程序也可能无法持续获取位置。这一点在开发需要后台持续定位的功能（如运动轨迹记录）时要特别注意。

第三层，才是我们开发者最常打交道的小程序自身的定位权限。也就是用户在小程序内看到的那个弹窗：“获取你的地理位置”。只有前两层都畅通，用户在这个弹窗点击了“允许”，你的wx.getLocation或wx.chooseLocation等API调用才会成功。

注意：这个漏斗模型是理解所有后续问题的基石。当定位失败时，你必须像侦探一样，从第三层开始，一层层向上排查，才能找到问题的根因。

2.2 微信小程序位置相关API速览

微信小程序提供了几个核心的API来处理位置，用途各不相同：

1. wx.getLocation：最常用，直接获取用户当前的经纬度坐标。它有几个关键参数：

   • type： 默认为wgs84，返回国际标准的GPS坐标。如果需要在小程序地图组件上显示，必须使用gcj02（国测局坐标系，也就是火星坐标系）。
   • altitude： 是否需要获取高度信息，默认为false。开启后在某些支持设备上可以获取海拔。
   • isHighAccuracy与highAccuracyExpireTime： 高精度模式相关。开启后会同时使用GPS、Wi-Fi、移动网络来定位，速度更快、精度更高，但耗电也更多。

2. wx.chooseLocation：打开地图，让用户手动点选一个位置。这个API会调起微信内置的地图选点界面，用户选择后返回地点名称、地址和坐标。它不需要用户授权定位权限，因为它本质上是用户主动选择的一个动作。

3. wx.openLocation：打开微信内置地图，查看指定的经纬度位置。常用于“查看门店地址”功能。它也不需要提前获取定位权限。

4. wx.startLocationUpdate与wx.onLocationChange：用于后台持续监听位置变化，比如跑步记录。这类功能需要用户授权，并且对小程序类目有严格要求，通常需要“社交-笔记”或“运动”等类目，审核更严格。

搞清楚每个API的用途和权限要求，是正确设计流程的前提。你不能在用户一进入小程序就粗暴地调用wx.getLocation，也不能在用户只想选个地址时，却误用了需要持续授权的后台定位API。

3. 标准授权流程设计与实战代码

一个健壮的授权流程，应该覆盖用户从初次接触到最终同意的完整路径，并妥善处理拒绝和异常情况。下面是我总结并经过多个项目验证的标准流程。

3.1 第一步：检查与请求授权状态

在尝试获取位置前，必须先检查当前的授权状态。直接调用wx.getLocation，如果用户没授权，它会失败并进入fail回调，但这种体验是粗暴的。我们应该使用wx.getSetting先窥探一下。

// pages/index/index.js Page({ onLoad: function() { this.checkLocationAuth(); }, checkLocationAuth: function() { wx.getSetting({ success: (res) => { // res.authSetting['scope.userLocation'] 可能的值： // undefined - 从未询问过授权 // false - 曾经询问过，但用户拒绝了 // true - 用户已授权 const locationAuth = res.authSetting['scope.userLocation']; if (locationAuth === undefined) { // 情况1：从未询问，可以尝试直接发起授权请求 this.requestLocationAuth(); } else if (locationAuth === false) { // 情况2：用户之前拒绝了，需要引导用户手动开启 this.showAuthGuideModal(); } else if (locationAuth === true) { // 情况3：用户已授权，直接获取位置 this.getUserLocation(); } }, fail: (err) => { console.error('检查设置失败', err); // 降级处理，可以尝试直接获取，或者提示用户检查网络 } }); } })

3.2 第二步：发起授权请求与用户引导

对于locationAuth === undefined的情况，我们可以调用wx.authorize发起授权弹窗。

requestLocationAuth: function() { wx.authorize({ scope: 'scope.userLocation', success: () => { // 用户点击了“允许” console.log('授权成功'); this.getUserLocation(); }, fail: (err) => { // 用户点击了“拒绝” console.log('授权被拒绝', err); // 此时授权状态会变为 false // 不要在这里立即弹窗引导，用户体验不好。可以稍后在用户触发某个需要位置的功能时，再引导。 // 例如，可以设置一个标志位，当用户点击“附近门店”按钮时，再弹出引导打开的模态框。 this.setData({ showLocationGuide: true // 控制一个引导UI的显示 }); } }); }

这里有一个关键细节：wx.authorize在用户拒绝后，短时间内再次调用不会弹出授权窗口，而是直接进入fail回调。这是微信为了防止开发者频繁骚扰用户做的限制。因此，一旦用户拒绝，你就必须提供其他入口（如按钮）让用户手动去设置页开启。

3.3 第三步：处理用户已拒绝的引导方案

当locationAuth === false时，wx.authorize已经没用了。你必须引导用户点击按钮，跳转到小程序的设置页面去手动开启。

showAuthGuideModal: function() { // 可以展示一个自定义的模态弹窗，解释为什么需要位置权限，并提供两个按钮 wx.showModal({ title: '需要位置权限', content: '该功能需要获取您的位置信息，用于推荐附近内容。您已拒绝授权，是否去设置页面开启？', confirmText: '去设置', cancelText: '暂不需要', success: (res) => { if (res.confirm) { // 用户点击“去设置” this.openSettingPage(); } else { // 用户点击“暂不需要”，记录状态，提供无位置服务的降级功能 this.provideFallbackService(); } } }); }, openSettingPage: function() { // 注意：wx.openSetting 接口已调整，需要用户主动触发（如点击按钮）才能调用。 // 因此，上面的 showModal 的确认回调是符合要求的。 wx.openSetting({ success: (res) => { // 用户从设置页面返回了，重新检查授权状态 if (res.authSetting['scope.userLocation'] === true) { this.getUserLocation(); } else { // 用户去了设置页但依然没打开，或者直接返回了 console.log('用户未在设置页开启权限'); } }, fail: (err) => { console.error('打开设置页失败', err); } }); }

3.4 第四步：最终获取位置与错误处理

当确认用户已授权后，调用wx.getLocation。

getUserLocation: function() { wx.getLocation({ type: 'gcj02', // 用于腾讯地图/微信地图显示，必须用这个 altitude: true, // 如果需要海拔信息 isHighAccuracy: true, // 开启高精度 highAccuracyExpireTime: 3000, // 高精度定位超时时间(ms) success: (res) => { const { latitude, longitude, speed, accuracy, altitude, verticalAccuracy, horizontalAccuracy } = res; console.log('定位成功:', latitude, longitude); // 将坐标存储到全局或页面data中，供其他功能使用 this.setData({ userLocation: { latitude, longitude } }); // 可以继续执行依赖位置的后继逻辑，如请求附近门店列表 this.loadNearbyShops(latitude, longitude); }, fail: (err) => { console.error('获取位置失败', err.errCode, err.errMsg); this.handleLocationError(err); } }); },

失败处理是整个流程中最体现功力的地方。wx.getLocation的失败原因多种多样，必须精细化处理。

handleLocationError: function(err) { const errCode = err.errCode; let errMsg = '获取位置失败，请稍后重试'; switch (errCode) { case 1: // 用户拒绝授权（理论上走不到这里，因为前面检查过了，但保底处理） errMsg = '位置权限被拒绝，请点击下方按钮手动开启'; this.setData({ showManualGuide: true }); break; case 2: // 位置服务不可用（手机系统定位服务关闭） errMsg = '请检查手机是否已开启定位服务（GPS）'; // 可以引导用户去打开系统定位服务，但小程序无法直接跳转系统设置 wx.showModal({ title: '提示', content: '您的手机定位服务已关闭，请进入系统设置>隐私>定位服务中打开。', showCancel: false }); break; case 3: // 获取位置超时（网络或信号问题） errMsg = '定位超时，请确保网络通畅并到开阔地带重试'; // 可以提供一个重试按钮 this.setData({ showRetryButton: true }); break; case 4: // 其他错误（如微信无定位权限） errMsg = '微信无定位权限，请检查手机中微信的权限设置'; break; default: errMsg = `定位失败(${errCode})，请检查网络和权限设置`; } wx.showToast({ title: errMsg, icon: 'none', duration: 3000 }); }

4. 高级场景与深度优化策略

基础流程跑通只是及格线。在实际项目中，我们还会遇到更复杂的场景，需要更精细的策略。

4.1 场景一：用户移动后的持续定位与权限时效

一个常见的误解是：“用户授权一次就一劳永逸了”。对于单次获取wx.getLocation，确实如此。但对于后台持续定位（wx.startLocationUpdate），情况就复杂了。

当小程序被切到后台，或者手机锁屏，微信可能会为了省电暂停位置更新。此外，如果用户最初授权的是“仅在使用期间”，那么后台定位也会失效。对于需要轨迹记录的App，必须在onShow生命周期里，重新检查定位是否还在进行，必要时重新发起。

更棘手的是权限的时效性。用户今天允许了，明天可能在手机系统设置里把微信的定位权限关了。因此，比较稳健的做法是，在每次小程序启动或从后台唤醒时，都重新执行一次“检查授权状态”的流程，而不是盲目认为权限还在。你可以将关键的定位状态（如hasLocationAuth）存储在全局App对象或本地存储中，但每次关键操作前，仍建议用wx.getSetting做一次快速校验。

4.2 场景二：安卓与iOS的差异化处理

安卓和iOS在权限管理上行为不一致，必须区别对待。

• 授权弹窗次数：iOS对wx.authorize的管控更严格。在iOS上，如果用户连续两次拒绝授权，系统会认为用户“永久拒绝”，此后调用wx.authorize将不再弹出任何窗口，直接失败。而安卓通常每次都会弹窗（除非用户勾选了“不再询问”）。这意味着在iOS上，你的引导逻辑要更前置、更友好，尽量避免用户走到“永久拒绝”那一步。
• 系统权限引导：当wx.getLocation返回错误码2（系统服务关闭）时，你无法通过代码直接跳转到系统的定位服务开关页面。在UI引导上，你需要为安卓和iOS用户提供不同的文字说明，指导他们如何一步步找到设置入口。例如，对iOS用户提示“请打开 设置 > 隐私与安全性 > 定位服务”，对安卓用户则根据手机品牌不同，提示路径可能为“设置 > 位置信息”或“设置 > 安全和隐私 > 定位服务”。
• 坐标系差异：虽然微信API已经帮我们做了转换（指定type: 'gcj02'即可），但如果你需要将坐标用于其他地图服务（如百度地图、高德地图的Web API），则需要知道，wx.getLocation获取的gcj02坐标，在传入百度地图API前，还需要进行一次坐标转换（百度使用bd09坐标系）。这是一个常见的跨平台坑点。

4.3 优化策略：提升授权通过率的技巧

授权被拒，很多时候不是因为用户真的不需要，而是因为你的请求时机和话术不对。

1. 时机选择（黄金法则）：永远不要在用户刚打开小程序、还没明白你能为他做什么的时候，就突然弹出位置请求。这会被视为骚扰。正确的做法是，将授权请求与一个明确的、能带来价值的功能点绑定。例如，在用户点击了“查找附近的咖啡店”按钮时，再弹出授权提示，并附带解释：“需要您的位置信息，才能为您找到最近的店铺”。这样，授权变成了获得服务的必要步骤，通过率会大幅提升。

2. 前置引导页设计：对于强依赖位置的核心功能（如打车、外卖小程序），可以在首页之前设计一个漂亮的引导页。用图文并茂的方式，清晰告知用户“获取位置能为您带来什么好处”（如：更快打到车、精准送达外卖）。在引导页的最后，放置一个醒目的“开启定位，立即体验”按钮，用户点击后再触发wx.authorize。这种主动的、有预期的授权，远比冷不丁的弹窗友好。

3. 优雅的降级方案：即使用户拒绝了位置权限，你的小程序也不应该瘫痪。必须提供降级方案。比如：

   • 让用户手动输入城市或地址。
   • 使用IP定位获取一个大概的城市级位置（精度较差，但可用于内容推荐）。
   • 提供热门城市列表让用户选择。
   • 记住用户上一次手动选择的位置。 并在UI上明确提示：“由于未获得位置权限，已为您展示[北京]的内容，您也可以手动切换城市”。这能让用户感到可控，未来更有可能重新打开权限。

5. 常见疑难杂症排查实录

在实际开发中，你一定会遇到一些匪夷所思的问题。下面是我遇到过的几个典型案例和解决方案。

5.1 真机调试正常，但体验版或正式版定位失败

这是最让人头疼的问题之一。可能的原因和排查步骤：

1. 检查小程序后台配置：登录微信公众平台，进入小程序管理后台，在“开发” -> “开发管理” -> “开发设置”中，确保“request合法域名”和“socket合法域名”已正确配置。如果你的位置服务需要请求自家服务器API来根据坐标反查地址或获取周边信息，那么你的服务器域名必须在此处添加。这是线上版本失败的最常见原因！
2. 检查AppID：真机调试时，开发者工具可能会使用测试号。但体验版和正式版使用的是你在后台配置的正式AppID。确认代码中app.json里没有写死测试AppID。
3. 权限声明检查：在app.json中，必须声明permission字段。

   { "permission": { "scope.userLocation": { "desc": "您的位置信息将用于为您提供附近的服务" // 这段描述会展示在授权弹窗中，务必写清楚！ } } }

   确保这里的描述文字（desc）清晰、友好、说明了用途。模糊的描述会导致用户拒绝。
4. 类目审核：某些与位置相关的复杂功能（如持续后台定位），可能需要特定的小程序类目，并在提审时额外说明。如果类目不符，审核可能被拒，或者功能被限制。

5.2 获取到的坐标偏差极大（飘移）

用户反馈定位到了几公里外，或者一直在跳动。

1. 坐标系错误：首先确认wx.getLocation的type参数是否为gcj02。如果你错误地使用了wgs84坐标，并直接把它画到腾讯地图组件上，就会发生严重偏移。
2. 室内或信号差环境：在高楼林立的市中心、室内或地下车库，GPS信号弱，定位会主要依赖基站和Wi-Fi，误差可能达到几百米甚至上千米。可以尝试：
   • 开启isHighAccuracy: true高精度模式。
   • 增加超时时间highAccuracyExpireTime。
   • 在UI上给用户提示“正在努力定位中，请移至开阔地带”。
   • 对获取到的连续多个坐标点进行平滑滤波处理（如取平均值、卡尔曼滤波），可以减少跳动，但无法解决根本性的精度问题。
3. iOS与安卓的差异：在相同环境下，不同品牌、不同系统的手机，其定位芯片和算法不同，精度和稳定性也会有差异。要有心理预期，无法做到完全一致。

5.3 授权弹窗不弹出或行为异常

1. 频繁调用限制：如前所述，用户拒绝wx.authorize后，短时间内再次调用不会弹窗。解决方案是：在用户拒绝后，将“请求授权”的入口替换为“引导去设置页开启”的按钮。
2. iOS“永久拒绝”后的处理：在iOS上，如果用户永久拒绝了，wx.authorize和wx.openSetting都无法再让授权弹窗出现。唯一的办法是引导用户长按小程序图标 -> 点击“关于xxx小程序” -> 进入权限设置页面进行修改，或者干脆删除小程序重新搜索打开。在你的引导文案里，需要明确写出这个操作路径。
3. 基础库版本兼容：微信小程序的基础库在不断更新，一些API的行为可能有细微调整。务必在app.json中设置合理的最低基础库版本，并在开发者工具中测试多个版本。关注微信官方的 更新日志 。

5.4 问题排查速查表

遇到问题，可以按以下顺序快速排查：

处理位置权限，本质上是在处理用户预期和技术限制之间的平衡。代码的健壮性很重要，但更重要的是产品逻辑和用户体验的设计。永远多替用户想一步：被拒绝了怎么办？定位不准怎么办？网络不好怎么办？把这些问题的解决方案都融入到你的流程里，你开发的小程序才会显得可靠、专业。