微信小程序｜NFC 读写教程｜机型兼容、失败降级与审核要点 – MPForge

一、NFC 适合什么场景，什么场景别用

结论先立：NFC 的价值在「贴一下即读」，前提是顾客手机支持、标签贴得够近；两者缺一个，就该用扫码。

适合 NFC 的场景集中在店内固定硬件旁：闸机核验、会员标签识别、设备巡检打卡。下面这些情况建议放弃：

• 线上传播、异地使用：NFC 要求物理贴近，远程场景只能走二维码，参考 小程序码参数与投放。
• 只识码不涉及硬件：普通收款码、商品码直接用 小程序扫码能力，成本更低、兼容性 100%。
• 需要双向指令交互：硬件联动优先评估蓝牙，参考 小程序蓝牙开发注意事项。

二、机型与写卡权限的边界

两道边界要先划清：读写能力在 iOS 与 Android 上支持程度不同；写卡比读卡权限敏感得多。

读卡侧，NFC 适配器初始化、订阅贴卡事件、解析 NDEF 数据的流程两端都有，但触发方式与系统弹窗体验不同，同一套代码在两个系统上的表现必须分别验收。写卡侧，平台对「往标签里写数据」的限制更严，涉及门禁、支付类标签时要先确认你的类目和资质能不能做。需要手机模拟成卡的场景（如模拟员工卡）走 HCE 主机卡模拟，参考 小程序 HCE 主机卡模拟配置 与 HCE 指令交互实现。划不清边界就先做「只读」版本上线，写卡二期再评估。

三、接入步骤：机型清单先于代码

顺序是：先定机型与场景清单，再写代码，最后补降级。按这五步走：

1. 定机型清单：列出目标顾客常用的 5 个以上品牌机型，标注系统版本；iOS 占比高的门店要特别确认读取体验。
2. 对齐权限文案：在功能页写清「为什么要贴近设备读取」，隐私与权限说明口径参考 用户隐私保护指引填写。
3. 实现读写流程：初始化 NFC 适配器、注册贴卡监听、解析数据并回显；每次读完及时释放适配器，避免下次进入失效。
4. 真机多品牌回归：至少覆盖清单里的 5 台真机，逐台记录「能读/读慢/读不到」，读不到的机型直接导流到降级入口。
5. 降级与提审：失败路径联调通过后，在审核备注里写清 NFC 用途、覆盖机型与降级方案。

四、失败降级与提示设计

读取失败的体验决定这个功能的口碑，提示文案要让顾客知道下一步做什么。验收对照：

降级入口要显性：读取页常驻「扫不出？试试扫码或输编号」入口，别藏在二级菜单。降级后的数据链路与 NFC 读取写进同一条核验记录，方便对账与复盘，核销场景可参考 核销码安全管理规范。

五、审核口径与避坑清单

审核被拒多因「宣传通用、实际部分机型不可用」，材料里主动坦白反而更容易过。提交前核对：

被拒后对照 微信小程序审核被拒常见原因 排查再重提，上线节奏参考 小程序上线发布检查清单。三条高频坑：

• 别让适配器泄漏：页面销毁不释放，二次进入监听失效，表现为「第一次能读第二次读不到」。
• 别在弱网下丢结果：读到标签后要回服务端核验，弱网超时要有本地提示与重试，参考 网络状态变化监听。
• 别夸大覆盖范围：机型兼容诚实标注，顾客预期管理好，投诉反而少。

六、常见问题 FAQ

五个高频问题，立项前先看完。