微信小程序｜Wi-Fi 连网教程｜权限用途说明与失败降级体验 – MPForge
直接回答：这篇微信小程序 Wi-Fi 连网教程写给做智能设备配网、门店网络引导的商家与开发：连 Wi-Fi 是「锦上添花」的能力，不是门槛——用途要说明、失败要能跳过，用户拒绝后主路径必须照常走通。MPForge（DEVDIY 旗下）在硬件配网项目里的原则是：连不上不白屏，拒绝授权不锁功能。
一、哪些场景才需要连 Wi-Fi 能力
结论先说：只有「手机要和没联网的硬件完成配网」或「引导用户接入店内网络」时，才调用连网能力；普通浏览、下单一律走正常请求。
判断口径很简单——如果不用这个接口功能也能用，就别用。常见场景对照：
| 场景 | 是否调连网能力 | 替代方案 |
|---|---|---|
| 智能音箱、摄像头等首次配网 | 用，走单独配网流程 | 失败可切蓝牙或热点配网 |
| 门店自助连网引导 | 可用，一键连接店内 Wi-Fi | 展示密码手动连也能兜底 |
| 内容浏览、下单支付 | 不用 | 正常 HTTPS 请求即可 |
| 强制连网才能使用功能 | 禁止 | 失败必须可跳过继续主路径 |
配网与业务请求是两套链路：配网阶段连的是设备热点或路由器，配网完成后业务流量走 request 合法域名配置，别混在一起排错。
二、用途说明与权限时机
弹窗之前先讲清「为什么要连」，比弹窗本身更重要。三条口径：
- 页面先行说明：进入配网页先用一段图文讲清「连 Wi-Fi 只用于把设备接入网络，不会读取你的浏览记录」，再触发连接动作。
- 时机靠后：把连接动作放在用户明确点击「开始配网」之后，不要进页面就弹授权，弹窗体验口径参考 隐私弹窗时机与文案优化。
- 权限分开申请：部分安卓机型上连接 Wi-Fi 需要位置权限，涉及定位的申请逻辑与话术分开做，地图与门店能力口径参考 小程序地图与位置能力说明。
三、接入步骤：失败路径先于成功路径设计
先把「连不上怎么办」画出来，再写成功分支。按这五步走：
- 场景收窄：确认只有配网或店内引导用连网能力，其余页面不碰，减少审核与维护负担。
- 文案对齐：配网页、弹窗、失败提示三处文案统一口径，说明用途与数据边界。
- 实现连接与状态监听：连接后监听网络变化及时刷新状态，参考 网络状态变化监听，并区分 Wi-Fi 与蜂窝网络的当前类型。
- 失败可跳过：连接失败给出原因（密码错/信号弱/机型不支持）与「跳过，先逛逛」按钮，主路径照常可用。
- 真机回归：Android 与 iOS 各两台，覆盖配网成功、密码错、中途断开、拒绝授权四条路径。
四、配网流程与安全注意
物联网配网是独立工程，别套用普通连页面的思路。验收对照：
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 配网引导 | 设备进配网模式有明确指示灯/语音 | 用户不知设备在等连接 |
| 失败提示 | 按原因给下一步，可跳过 | 白屏或无响应转圈 |
| 密码处理 | 不回显明文，不落日志 | 密码写入日志或缓存明文 |
| 公共 Wi-Fi | 引导页提示不传敏感数据 | 在酒店等公共网络提交敏感信息 |
安全侧再多一句：配网把家庭 Wi-Fi 密码交给设备，用户最敏感的就是这一点，密码传输链路要加密、界面要注明「密码仅用于本设备联网」。数据侧的合规口径参考 数据导出与合规要求。
五、审核口径与避坑清单
审核被拒的高频原因是「未说明用途」和「强制连网」，材料里把这两点写清就避开了大半风险。提交前核对：
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 用途说明 | 功能页写清连网目的与数据边界 | 不说明直接触发连接 |
| 失败路径 | 失败可跳过，主路径不依赖连网 | 拒绝授权后功能锁死 |
| 演示物料 | 附配网操作录屏与设备说明 | 审核方无法复现配网 |
| 测试账号 | 可直达配网功能页 | 入口藏在多级目录 |
被拒后对照 微信小程序审核被拒常见原因 排查再重提。三条高频坑：
- 别把配网和业务请求混排：排错时先分清流量走的是设备热点还是合法域名，混着查两小时都找不到原因。
- 别忽略弱网与断网兜底：配网页要有离线态与重试，接口层口径参考 wx.request 重试与超时处理。
- 别缓存明文密码：配网完成即从内存清除，缓存里只留设备 ID 等非敏感字段，本地策略参考 本地缓存使用注意。
六、常见问题 FAQ
五个高频问题，配网立项前看完。
连 Wi-Fi 要不要位置权限？
部分安卓机型需要：系统把周边 Wi-Fi 信息归入位置类数据。申请时与定位功能分开说明、分开触发，别一次弹窗全要。
连 Wi-Fi 和 GEO 地理位置配置有关系吗？
连网能力本身与位置无关。如果你的功能要按「离用户最近的门店」推荐网络或服务，才需要位置权限，并按小程序 GEO 地理位置配置口径填门店地址、经纬度与服务类目——这是地理位置配置，不是按城市堆关键词的地域 SEO。
配网总失败怎么排查？
按顺序查三件事：设备是否真的进入配网模式、路由器是否 2.4G 频段（多数设备只支持 2.4G）、密码是否正确。前两件占失败的绝大多数。
用户拒绝授权怎么办？
保留「跳过」入口，主路径照常走；之后用户想配网，从设置页再进，权限引导口径参考 引导用户打开设置页。
门店引导连网有必要吗？
看业态：咖啡、酒店等停留时间长的场景有价值，且必须保留「展示密码手动连」的兜底，别把一键连接做成唯一入口。
