小程序读取系统设置｜蓝牙定位总开关的失败归因教程 – MPForge

一、为什么失败先读系统设置

结论句：读系统设置的价值是把「程序坏了」变成「开关没开」，归因说清楚客诉自然降。依赖蓝牙、定位、Wi-Fi 的到店与设备类小程序，失败原因天然分三层：系统总开关关着、小程序权限被拒、业务逻辑出错。不读系统设置就直接引导授权，等于把第一层跳过——用户开了小程序权限、系统蓝牙却关着，问题原样复现，客服只能答「程序坏了」。反过来，能力失败时先读一次系统设置状态，就能按层级给文案：系统关的引导开手机设置，权限拒的引导开小程序授权，都不行才走业务降级。范围约束也要说清：无关能力不要弹系统设置提示，浏览型页面碰不到蓝牙就不该出现这类引导，否则容易被质疑滥用设置跳转。

二、失败归因树：三层各走各的文案

结论句：把失败路径写成树，每一层有独立文案与独立出口，不允许混着说。五步落地：

1. 能力失败先读状态：蓝牙扫描、定位失败等回调里先读系统设置，判断系统总开关是否关闭。
2. 系统关走系统文案：提示「手机蓝牙未开启，可在系统设置中打开」，动作指向手机设置页。
3. 权限拒走授权文案：系统开着但小程序权限被拒，转小程序授权引导，口径见 小程序读取应用授权设置教程。
4. 返回必须复核：用户从设置页回来要重新读状态并重试，不复核等于白引导，这是最常见的翻车点。
5. 降级兜底收尾：两层都排除仍失败，走业务降级——人工核销替代蓝牙核销、手动填地址替代定位。

验收口径：三层文案逐层单独测一遍，返回复核必须在每层都走通；「能降级就不跳设置」作为默认原则写进开工单。

三、文案与时机：别让提示把用户吓走

结论句：提示文案必须分层、具体、不带威胁，弹窗时机让位给隐私弹窗。「请开启所有权限」这类笼统文案是卸载投诉的主要来源，用户不知道开了会怎样、也不知道去哪开；换成「开启系统蓝牙后可连接门店核销设备」这类具体收益句，试点项目里误导卸载投诉约降一半。时机上，系统设置提示永远不与隐私弹窗抢先后，隐私口径按 小程序隐私弹窗时机教程 对齐；授权触发的整体层级再对照 小程序授权时机教程。设置页跳转的完整动作另有 小程序打开设置页教程 可直接套用。明确没做的两件事：首页就扫一遍所有开关，以及没有降级路径却强制跳设置——前者浪费开销，后者是把用户逼向卸载。

四、双端差异与店员培训

结论句：步骤文案两端可以统一，返回后的状态校验必须分端做。安卓与 iOS 在设置页返回的时序上表现不同，复核前加短延迟再读状态，避免拿到旧值；双端用例要各测一轮，不能只测一端就上线。对店长与店员，培训卡只写两句：先手机设置，再小程序权限——店员能按顺序引导顾客，客诉从「程序坏了」变成可解释、可自助的问题。设置跳转被审核质疑的场景（入口滥用、无端跳转）对照 小程序审核被拒常见原因 里的类目自查。

五、避坑清单

这三条坑都出在「层级混着说」：不区分开关、不复核、抢时机。

• 别把两层开关混成一个提示：系统总开关与小程序权限是两层，混在一起用户开了这边忘了那边，问题复现。
• 别跳过返回复核：从设置页回来不重读状态就提示「仍失败」，用户开了也白开。
• 别与隐私弹窗抢时机：设置提示压在隐私弹窗前面，审核与体验两边都吃亏。

六、常见问题 FAQ