React Native NFC读取iOS正常Android失效，求调试排查方案

我们基于react-native-nfc-manager在React Native应用中实现了NFC标签扫描功能，iOS端运行正常，但Android设备上无法读取标签——await NfcManager.getTag()始终无返回。

已确认测试设备三星A10（Android 11）支持NFC，且NFC Tools应用可正常读取目标标签，问题出在代码层面。已检查AndroidManifest.xml配置，点击扫描按钮启动技术请求后无报错，但扫描标签无响应。通过Android Studio查看Logcat仅输出以下日志：

2024-09-19 23:05:01.901 14222-14419 ReactNativeNfcManager org.gearlog.app D isSessionAvailable: false
2024-09-19 23:05:01.905 14222-14419 ReactNativeNfcManager org.gearlog.app D registerTagEvent
2024-09-19 23:05:01.908 14222-14419 ReactNativeNfcManager org.gearlog.app I enableForegroundDispatch, enable = true

后续无其他日志输出。请问如何生成更多调试日志以排查问题？

相关代码：

async scanNFC() {
    try {
      alert('We see this message');
      await NfcManager.requestTechnology(NfcTech.Ndef);
      alert('We never see this message');
      const tag = await NfcManager.getTag();

      // 标签解析代码，但从未执行到这里
     
    } catch (ex) {
        // 错误提示代码
    } finally {
        NfcManager.cancelTechnologyRequest();
    }
  }

一、开启库内置 verbose 日志 #

react-native-nfc-manager本身支持详细日志输出，在App初始化阶段添加以下代码即可开启：

import NfcManager from 'react-native-nfc-manager';

// 在App启动时调用
NfcManager.setLogLevel('verbose');

开启后，Logcat会输出库内部NFC会话建立、技术匹配、标签交互等全流程细节，帮助定位卡壳环节。

二、给业务代码添加关键节点日志 #

在scanNFC函数中插入自定义日志，追踪代码执行路径，同时添加超时检测确认是否卡在技术请求阶段：

async scanNFC() {
    try {
      console.log('[NFC Debug] 启动扫描，准备请求NDEF技术');
      alert('We see this message');
      
      // 给技术请求添加超时逻辑，避免无限等待
      const techRequest = NfcManager.requestTechnology(NfcTech.Ndef);
      const timeout = new Promise((_, reject) => {
        setTimeout(() => reject(new Error('NDEF技术请求超时（10s）')), 10000);
      });

      await Promise.race([techRequest, timeout]);
      console.log('[NFC Debug] 成功获取NDEF技术权限');
      alert('We never see this message');
      
      console.log('[NFC Debug] 开始读取标签数据');
      const tag = await NfcManager.getTag();
      console.log('[NFC Debug] 读取到标签:', JSON.stringify(tag));

      // 标签解析代码
     
    } catch (ex) {
        console.error('[NFC Debug] 扫描异常:', ex.message, ex.stack);
        // 错误提示代码
    } finally {
        console.log('[NFC Debug] 取消NFC技术请求');
        NfcManager.cancelTechnologyRequest();
    }
  }

通过Logcat查看这些自定义日志，能直接确认代码是否卡在requestTechnology阶段，以及具体错误信息。

三、Android原生层添加配置验证日志 #

在Android原生代码（如MainActivity.java）中添加日志，验证NFC权限、适配器状态及意图接收情况：

import android.nfc.NfcAdapter;
import android.content.pm.PackageManager;
import android.content.Intent;
import com.facebook.react.ReactActivity;

public class MainActivity extends ReactActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // 验证NFC权限
        if (checkSelfPermission(android.Manifest.permission.NFC) == PackageManager.PERMISSION_GRANTED) {
            android.util.Log.d("NFC Debug", "NFC权限已获取");
        } else {
            android.util.Log.d("NFC Debug", "未获取NFC权限");
        }
        // 验证NFC适配器状态
        NfcAdapter nfcAdapter = NfcAdapter.getDefaultAdapter(this);
        if (nfcAdapter != null && nfcAdapter.isEnabled()) {
            android.util.Log.d("NFC Debug", "NFC功能已启用");
        } else {
            android.util.Log.d("NFC Debug", "NFC未启用或设备不支持");
        }
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        // 验证是否收到NFC意图
        android.util.Log.d("NFC Debug", "收到NFC意图: " + intent.getAction());
        // 将意图传递给NFC Manager
        com.reactnativecommunity.nfc.NfcManagerModule.onNewIntent(intent);
    }
}

这段代码能确认设备是否检测到NFC标签并发送了意图，以及应用的NFC基础配置是否正常。

四、Android Studio工具辅助调试 #

1. 在Logcat中，通过标签过滤器ReactNativeNfcManager和自定义的NFC Debug筛选日志，聚焦NFC相关输出；
2. 使用Profiler工具查看应用进程的NFC系统调用，确认是否有底层交互异常。

额外排查提示 #

从现有日志看，前台调度已启用但无后续交互，可能是目标标签不支持NDEF技术（比如Mifare Classic无NDEF分区），可尝试请求更通用的NFC技术集：

await NfcManager.requestTechnology(
  NfcTech.IsoDep | NfcTech.NfcA | NfcTech.NfcB | NfcTech.NfcF | NfcTech.NfcV | NfcTech.Ndef
);

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