小程序连接 Wi-Fi 教程｜场景说明、失败继续与安全提示 – MPForge
直接回答：这篇小程序连接 Wi-Fi 教程写给要在门店或酒店场景里用无线网络能力的商家与开发：解决三个问题——什么场景才值得联网、连接失败时怎么让用户照样办成事、安全与审核说明怎么写才不踩坑。MPForge（DEVDIY 旗下）在门店类目项目里反复验证过这套口径，Wi-Fi 能力用对了是体验加分项，用错了就是使用门槛。
一、什么场景才值得动用 Wi-Fi 能力
只有「连上店内 Wi-Fi 才能完成业务」的场景才需要它，别为了技术炫技强迫用户联网。
适合的场景很具体：门店里要让顾客设备连接店内网络后完成点单或设备配对；酒店类小程序帮住客快速接入客房 Wi-Fi； IoT 配网（智能音箱、摄像头绑定）需要把 Wi-Fi 密码传给硬件。除此之外的普通浏览、下单、查询，走流量和常规请求就够了——用户在流量充足的环境里被弹「请先连接 Wi-Fi」，只会觉得被冒犯。物联网配网是另一套流程，涉及把 SSID 和密码写入设备，验收标准完全不同，不要和「连 Wi-Fi 上网」混在一个流程里做。
给商家一个判断句：如果去掉 Wi-Fi 这个环节，业务流程依然完整，那这个环节就不该是强制的。开发侧同理，先把主路径跑通，再评估联网能力加在哪里最不打扰。
二、提审前要备齐的三样材料
材料不齐，驳回基本是必然：场景说明、失败继续路径、安全提示，一样都不能少。
- 场景说明：用一两句话写清「为什么要连 Wi-Fi、连了之后能干什么」，这段文案既要给用户看，也是审核材料里的口径，写「优化体验」这种空话过不了。
- 失败继续路径：密码错误、信号弱、用户拒绝授权时，页面必须能降级到不依赖 Wi-Fi 的主流程，绝不允许白屏或死等。
- 安全提示：涉及公共 Wi-Fi 的场景要有风险告知，密码不能明文打日志，鉴权信息走服务端。
这三样建议写进需求文档同一段落，开发按文档实现，运营按文档写页面文案，审核按文档核对，三方对的是同一份口径。
三、实操步骤：从收窄场景到真机验收
顺序很重要：先收窄使用范围，再做文案与降级，最后才是提审。按这五步走：
- 收窄场景：列出所有打算调起 Wi-Fi 的页面，逐个问「这页不联网能不能用」，能用的页面全部摘掉联网前置。
- 文案对齐：场景说明按第二节口径写，同时检查权限弹窗时机，别在用户还没看懂页面时就弹授权；弹窗体验可参考 小程序隐私弹窗体验优化。
- 失败可跳过：给连接失败设计明确的「跳过」按钮，失败后进入正常主流程，并把失败原因记到日志里而不是只弹个 toast。
- 真机多品牌：至少覆盖 Android 和 iOS 各两台真机，各家系统对 Wi-Fi 接口的支持程度有差异，模拟器验证不算数。
- 审核说明：提审备注里写清使用场景与失败降级方案，与页面文案一致；常见驳回原因可对照 微信小程序审核被拒常见原因。
四、上线前检查表：逐项打勾再提审
拿这张表当验收单，三列对照着过，全部达线再提审。
| 检查项 | 达标口径 | 常见错误 |
|---|---|---|
| 场景说明 | 说清「为何连、连上后干什么」，与提审备注一致 | 只写「优化用户体验」 |
| 失败路径 | 密码错、拒授权、信号弱三条路径都能继续用 | 失败后白屏或无限转圈 |
| 强制联网 | 主流程不依赖 Wi-Fi，联网只是增强项 | 不连 Wi-Fi 就不给用 |
| 权限申请 | Wi-Fi 与定位分开申请，文案各自独立 | 两个权限捆在一句弹窗里 |
| 安全处理 | 密码不明文落日志，公共 Wi-Fi 有风险提示 | 密码直接 console 打印 |
五、避坑清单：三个最贵的坑
这三个坑都在「把联网当成门槛」这件事上，避开就避开了大部分驳回。
- 别强制联网才能用：审核和用户都反感「不连 Wi-Fi 不能进」，联网必须是可选增强，主流程始终可用。
- 别让失败变白屏：连接失败要有兜底文案和跳过按钮，失败率数据建议进监控，超过阈值就复查密码下发流程。
- 别把密码写进日志：Wi-Fi 密码属于敏感信息，明文落日志既有过泄露风险，也过不了安全评估。
- 别把 Wi-Fi 当定位用：想按位置推荐服务，靠的是GEO 地理位置配置（门店地址、经纬度），不是靠联网行为推断，两者能力完全不同。
六、常见问题 FAQ
酒店类小程序帮客人连 Wi-Fi，要注意什么？
重点是安全与知情：连的是公共网络，页面要有风险提示，客人信息不因联网行为被额外采集；连接失败时入住、报修等主功能照常可用。
连 Wi-Fi 和定位权限要一起申请吗？
分开申请。两者用途不同，捆在一句弹窗里既容易一起被拒，也让用户难以判断该不该授权；各自用独立文案说明用途。
Wi-Fi 密码能存在前端缓存里吗？
不建议明文存。需要传给设备做配网时走加密通道，日志里只留脱敏后的关键字段；历史项目里密码明文落日志是最常见的整改项。
连接 Wi-Fi 和 GEO 地理位置配置有关系吗？
没有。GEO 指地理位置配置——门店地址、经纬度、服务类目，决定小程序在「附近」检索里的展示；连接 Wi-Fi 只是网络能力，不能替代 GEO 配置，也别指望靠联网行为做地域营销。
Wi-Fi 能力在审核里容易被拒吗？
高频驳回点是强制联网、用途说不清、失败无降级。把场景说明写具体、失败路径做扎实，对照小程序 Wi-Fi 能力注意事项自查一遍再提审，通过率会明显提升。
想把 Wi-Fi 能力接得稳、过审快？
MPForge（DEVDIY 旗下）按类目与场景帮你定联网方案、写场景说明、把失败降级做成可验收用例，门店与酒店类目项目都有现成经验。
