1. 别急着上原生 App:为什么我盯上了 Web NFC
先交代一下背景。我手头有个很实际的需求:仓库里贴了一批 NFC 标签,每个标签对应一台设备的唯一编号,巡检人员需要经常读取这些编号,然后把它转成二维码贴到交接单上。以前的做法是拿一台预装了原生 App 的安卓机去刷,App 解析出来之后还得手动抄号、再找个二维码工具生成。整个过程非常繁琐,而且那台专用安卓机一旦坏了或者系统被更新,整个流程就停摆。
后来我试着用 GLM-5 帮我搭了个原型——直接用 HTML5 + JavaScript 调 Web NFC API,把“读卡”和“转二维码”这两件事全部塞进浏览器里。试完之后我发现这事远比预期靠谱:不需要装任何 App,手机上打开一个网页就能读 NFC 标签,读完自动跳转到包含设备编号的二维码,再拿另一台设备扫这个码就能打开设备详情页。整套流程 30 秒内完成,而且跨平台,只要有支持 Web NFC 的浏览器就能跑。
这篇文章把我从零到上线这条路上踩过的坑、做过的取舍、以及最终稳定运行的实现方式完整记录下来。适合谁看?两类人:一类是跟我一样需要在浏览器里接 NFC 硬件的开发者,另一类是考虑“用 Web 技术做业务工具,而不是又去开发一个 Android/iOS App”的产品和技术决策者。我先把结论放在这里:如果你的使用场景是安卓 Chrome 系浏览器为主,Web NFC 完全够用,而且从立项到能跑通 Demo,比原生开发至少快一倍以上。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. GLM-5 生成的初版代码,以及我改掉的三个问题
2.1 提示词怎么写,才能让 AI 给出可运行的原型
既然标题里提到了 GLM-5,我得说说这段经历。很多人用大模型写代码,上来就一句“帮我写个 NFC 读卡页面”,结果出来的代码要么是调用了不存在的 API,要么是拿二维码库拼凑但完全没理解需求。我的做法是分两步给提示词:第一步描述业务场景,第二步提具体技术约束。
我实际使用的提示词大概长这样:
你是一个熟悉 Web NFC API 的前端工程师。我要实现一个 H5 页面,运行在安卓 Chrome 浏览器上,功能是:用户点击页面上的按钮后,触发 NFC 标签读取;读取成功后,在页面上显示标签里的设备编号,并自动生成对应二维码。要求:使用 navigator.nfc.read(),只读一次,不持续扫描;页面需要处理用户拒绝权限、NFC 不支持、读取超时三种异常;界面用简洁的移动端布局,中文提示。
这样做的效果是:GLM-5 给出了一个约 80 行的 HTML 页面,包含一个按钮、一个展示区域、一段基于 qrcodejs 的二维码生成逻辑。当然,初版代码并不能直接上线,它只是把我的思路变成了一个可跑通的骨架。关键意义在于——大模型把“从零开始写”变成了“在已有骨架上改”,省掉的是最枯燥的框架搭建时间。
2.2 初版代码里最典型的三处毛病
我这里不是黑 GLM-5,实际上这三类问题在我过去用各种代码生成工具时都遇到过,属于 AI 生成前端代码时的通病。
第一,权限状态管理缺失。 初版代码只在页面加载时判断一次 "NFC" in navigator,然后就绑定了按钮事件。但实际场景中,用户可能第一次点了“允许”,之后在系统设置里手动关掉了 NFC 权限,这时浏览器不会重新弹授权框,读取会静默失败。我改成了在每次点击按钮时都检查 navigator.permissions.query({ name: "nfc" }),根据权限状态给出对应的 UI 提示。
第二,NDEFMessage 的解析逻辑太天真。 初版代码假设标签里存的是一条纯文本记录,直接 record.data 转字符串,这在大多数简单标签上没问题。但实际仓库里的标签有的是 URL 格式开头,有的是空记录开头,还有的是厂商写入的 TNF 类型标识。后来我改成遍历 message.records,逐个判断 record.type 是 "text" 还是 "url",再按需解析,这样兼容性大幅提升。
第三,二维码生成时机没把控。 初版代码是在 reading 事件的回调里同步生成二维码,看起来没毛病。但 Web NFC 的读取回调里如果做大量 DOM 操作,某些国产浏览器内核的 WebView 会把 NFC 事务的响应延迟拉高,导致同一个标签被读到两三次,二维码闪烁。解决办法是把二维码生成放到 requestAnimationFrame 或 setTimeout(0) 里,先更新状态,再生成码图,最后统一渲染。
3. Web NFC 核心 API 拆解:从 NDEF 数据格式到读取流程
3.1 NDEF 到底是什么,为什么读取要看 record.type
如果你之前没接触过 NFC 的底层数据格式,直接看 Web NFC 的文档会有点懵——它所有读取操作都围绕“NDEF 消息”展开。NDEF 全称 NFC Data Exchange Format,是 NFC Forum 定义的通用数据封装格式,你可以把它理解成一个“信封”,里面装着一条或多条“记录”,每条记录由头部(含类型、长度等元信息)和载荷(实际数据)组成。
举个例子:你用手机上的某个工具往标签里写入一段文本“DEVICE-0842”,这个数据在底层会被封装成一条 NDEF 记录,type 字段是 "text",data 字段是 "DEVICE-0842" 的字节序列。如果你写的是一个网址,比如 https://example.com/dev/0842,type 字段会是 "url",按照 NFC Forum 的规
