使用react-native-nfc-manager时部分Android设备NFC扫描失效问题求助

问题原因分析 #

从Samsung A53的ADB日志及设备表现来看，核心问题集中在Android NFC服务的技术匹配逻辑：

• 错误码status=5对应NCI层的NFA_STATUS_FAILED，说明设备尝试连接标签时，默认扫描的技术集与标签支持的IsoDep/NfcA不匹配，导致连接失败。
• 日志中only found NFC-DEP technology表明部分三星、Pixel设备的NFC服务默认优先尝试点对点通信的NFC-DEP技术，而非标签支持的NFA/NDEF相关技术，进而无法识别标签内容。
• 当前代码未指定扫描的技术过滤规则，不同厂商的NFC服务默认行为差异导致部分设备无法适配目标标签。

解决方案 #

1. 强制指定扫描的NFC技术类型 #

修改registerTagEvent调用，明确指定目标标签支持的技术类型，避免设备使用默认扫描集：

// 先导入技术常量
import { NfcTech } from 'react-native-nfc-manager';

// 在useEffect中修改注册逻辑
NfcManager.registerTagEvent({
  techs: [NfcTech.NfcA, NfcTech.IsoDep], // 匹配标签支持的技术
});

2. 增加标签读取重试逻辑 #

针对部分设备连接不稳定的情况，在首次未读取到NDEF内容时，手动发起技术请求重试：

NfcManager.setEventListener(NfcEvents.DiscoverTag, async (tag: TagEvent) => {
  if (!isActive) return;
  showNFCScreen();

  let ndefMessage = tag?.ndefMessage;

  // 重试读取逻辑
  if (!ndefMessage) {
    try {
      await NfcManager.requestTechnology(NfcTech.NfcA);
      const rawTag = await NfcManager.getTag();
      ndefMessage = rawTag?.ndefMessage;
      await NfcManager.cancelTechnologyRequest();
    } catch (err) {
      console.warn('Retry read failed:', err);
    }
  }

  if (ndefMessage?.[0]) {
    // 处理NFC标签内容
  } else {
    setNfcScanError(1);
  }
});

3. 排查权限与系统设置 #

• 确认AndroidManifest.xml中已配置NFC权限：

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

• 指导用户检查设备NFC设置：重启NFC功能，确保“读取NFC标签”等相关开关处于开启状态（部分三星设备需在「NFC和支付」中确认）。

4. 针对三星/Pixel设备的特殊处理 #

排除NFC-DEP技术，避免设备优先尝试点对点连接：

NfcManager.registerTagEvent({
  techs: [NfcTech.NfcA, NfcTech.IsoDep],
  excludeTechs: [NfcTech.NfcDep], // 禁用NFC-DEP扫描
});

验证步骤 #

1. 重新打包应用并安装到问题设备
2. 扫描目标标签，观察ADB日志是否不再出现NFA_SELECT_RESULT_EVT error: status = 5
3. 确认标签NDEF内容可正常读取

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