Web NFC API必须在HTTPS或localhost安全上下文中使用，否则NDEFReader构造函数抛出SecurityError；仅Chrome 90+和Edge 117+支持，Safari与Firefox完全不支持；所有操作须由用户手势触发，且需设备NFC开启并解锁屏幕。
Web NFC API 只能在安全上下文中使用
不启用 HTTPS（或 localhost）时，NDEFReader 构造函数会直接抛出 SecurityError，浏览器甚至不会提示权限请求。Chrome 90+ 和 Edge 117+ 支持该 API，但 Safari 和 Firefox 完全不支持——这点必须提前确认，否则调试半天发现是浏览器限制。
常见错误现象：TypeError: Failed to construct 'NDEFReader': NDEFReader is not available 或控制台静默无反应。
- 开发阶段务必用
http://localhost:8080启动服务（如npx serve、python3 -m http.server 8080），不能双击打开 HTML 文件 - 生产环境必须部署在 HTTPS 域名下；HTTP/2 不是必需，但 TLS 版本需 ≥ 1.2
- 部分安卓 Chrome 会要求设备开启 NFC 并解锁屏幕——即使标签已贴近，未解锁也会触发
AbortError
读取 NFC 标签需显式请求用户许可
NDEFReader.scan() 不是“监听即读”，而是每次调用都触发一次用户手势授权（如点击按钮），且仅对接下来几秒内靠近的标签生效。没有自动轮询，也不能后台常驻。
典型误用：页面加载后立即调用 scan()，结果报错 NotAllowedError: Permission request must be triggered by user gesture。
- 必须绑定到用户可交互元素，例如：
- 调用前检查兼容性：
if ('NDEFReader' in window) { ... }，避免在不支持环境报错中断逻辑 - 扫描成功后，
scan()返回的 Promise 会 resolve 一个event，其message.records是Array，每个 record 有recordType（如"text"）、data（Uint8Array）等字段
const reader = new NDEFReader();
await reader.scan(); // 用户点击后才执行
reader.addEventListener('reading', event => {
const text = new TextDecoder().decode(event.message.records[0].data);
console.log('读到文本：', text);
});
写入 NFC 标签需要目标标签支持可写且未被锁定
NDEFWriter.write() 的成功率远低于读取。它要求标签是 NDEF 格式、有足够剩余空间、未写保护（如 NTAG213 默认可写，但 NTAG216 若被 lock 区域写过就不可再写）。
从零开始创建惊艳、动画丰富且自包含的 HTML 演示文稿，或通过转换 PowerPoint 文件生成。当用户希望制作幻灯片、构建演示文稿、打造路演资料（pitch deck）、将 PPT/PPTX 转换为网页格式，或增强现有 HTML 演示文稿时，应使用此能力。该能力帮助用户通过视觉预览而非抽象选项来发掘自身审美偏好。
错误现象包括：NotSupportedError: Write operation not supported on this tag、OperationError: Failed to write to tag，但通常不提示具体原因。
- 写入内容必须封装为
NDEFMessage对象，不能直接传字符串：new NDEFMessage([{ recordType: 'text', data: new TextEncoder().encode('hello') }]) - 安卓 Chrome 要求设备 NFC 天线正对标签背面（多数手机天线在摄像头附近），偏移 >2cm 就容易失败
- 写入过程无进度反馈，超时约 5 秒，期间用户需保持标签贴合；失败后需重新调用
write()，不能复用同一NDEFMessage实例
跨平台行为差异大，别依赖统一表现
Chrome for Android 表现最稳定；Windows 上 Edge 虽支持 API，但实际仅能读取部分 Type 4 标签（如 Smart Poster），对常见 MiFare Ultralight 基本无效；iOS 完全无 Web NFC 支持，'NDEFReader' in window 永远为 false。
更隐蔽的问题：同一部安卓机，升级 Chrome 到 125 后，对某些 NTAG215 标签写入成功率从 80% 降到 20%，重启 NFC 或换标签批次可能临时恢复——这种硬件级抖动无法靠代码规避。
- 业务中若需强可靠性，Web NFC 只适合做轻量演示或辅助功能，核心流程仍应提供手动输入 fallback
- 不要在
catch中只打印 error.name，error.message才含实际线索（如 “Tag is locked”、“Unsupported record type”） - 测试务必用真实标签，模拟器或 NFC 工具 App（如 NFC Tools）发出的信号不触发 Web NFC 事件
实际跑通的关键不在代码多精巧，而在三件事：HTTPS 环境、用户点击触发、手稳贴住标签两秒以上。其余全是和不同标签型号、系统版本、Chrome 小版本之间的耐心博弈。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
