Flutter NFC_manager包在Android设备上无法读取NFC标签求助

1. 核对Android权限配置 #

• 确认AndroidManifest.xml已添加基础NFC权限：

  <uses-permission android:name="android.permission.NFC" />
  <uses-feature android:name="android.hardware.nfc" android:required="true" />
  

• 若设备是Android 12及以上版本，必须补充前台NFC权限并动态申请：

  <uses-permission android:name="android.permission.NFC_TRANSACTION_EVENT" />
  

  代码中需调用权限申请逻辑，否则系统会拦截NFC扫描请求。

2. 检查前台调度参数设置 #

启动NFC会话时，需明确开启Android的阅读器模式，确保系统优先将NFC事件传递给当前App：

await NfcManager.instance.startSession(
  onDiscovered: (NfcTag tag) async {
    // 处理标签数据逻辑
    await NfcManager.instance.stopSession();
  },
  options: NfcSessionOptions(
    android: AndroidNfcSessionOptions(
      foregroundMode: true,
      enableReaderMode: true, // 关键参数，必须开启
    ),
  ),
);

3. 适配目标标签类型 #

如果你的NFC标签是特定类型（比如MIFARE Classic），需在会话配置中指定支持的标签技术：

options: NfcSessionOptions(
  android: AndroidNfcSessionOptions(
    techLists: [
      [NfcA.type],
      [MifareClassic.type],
      [MifareUltralight.type],
      // 按需添加其他标签类型
    ],
  ),
),

4. 排除系统与第三方冲突 #

• 关闭手机后台所有NFC相关App，避免抢占NFC事件通道；
• 重启手机NFC功能或直接重启设备，修复系统NFC服务临时异常。

5. 捕获详细错误日志 #

在启动会话的代码块中增加异常捕获，打印具体错误信息：

try {
  await NfcManager.instance.startSession(...);
} catch (e) {
  print('NFC扫描异常: $e');
}

通过日志可以精准定位是权限问题、标签不兼容还是系统调度异常。

内容的提问来源于stack exchange，提问作者Boolhwi