React Native NFC读卡异常问题：requestTechnology仅在应用从后台切至前台时触发且getTag报‘no reference available’错误

从你的描述和代码来看，这两个问题其实是相关的，核心原因在于Android的NFC前台调度机制没有被正确初始化，导致requestTechnology无法正常触发，进而引发getTag()找不到有效tag引用的错误。下面一步步分析并给出解决方案：

一、为什么必须切后台再切前台才能触发requestTechnology？ #

Android系统的NFC前台调度（Foreground Dispatch）需要应用在前台时主动注册，才能获取NFC事件的优先级。你的代码里虽然在componentDidMount启动了NfcManager，但可能存在以下问题：

• 初始化时机过早，NfcManager还未完全绑定系统NFC服务就尝试调用requestTechnology
• AndroidManifest中缺少必要的NFC权限和intent filter配置，导致系统无法将NFC事件路由到你的应用
• Oppo设备的系统优化（比如后台限制），导致应用启动时NFC前台调度未被正确注册

当你把应用切后台再切前台时，系统会重新检测前台应用的NFC配置，此时NfcManager已经完成初始化，前台调度被正确激活，所以requestTechnology能正常触发。

二、getTag()报错「no reference available」的关联原因 #

getTag()需要依赖requestTechnology成功建立的NFC会话来获取tag对象。如果requestTechnology只是表面进入了then回调但实际未获取到有效的NFC技术（你提到value为空），说明会话并未真正建立，自然找不到可用的tag引用，从而抛出错误。

三、具体解决方案 #

1. 完善AndroidManifest配置 #

确保你的AndroidManifest.xml包含以下配置：

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

<!-- 在主Activity中添加NFC事件过滤 -->
<activity ...>
    <intent-filter>
        <action android:name="android.nfc.action.TECH_DISCOVERED" />
    </intent-filter>
    <meta-data 
        android:name="android.nfc.action.TECH_DISCOVERED"
        android:resource="@xml/nfc_tech_filter" />
</activity>

然后在res/xml目录下创建nfc_tech_filter.xml文件，定义支持的NFC技术：

<resources xmlns:xliff="urn:oasis:names:tc:xliff:document:1.2">
    <tech-list>
        <tech>android.nfc.tech.MifareClassic</tech>
        <tech>android.nfc.tech.NfcA</tech>
        <tech>android.nfc.tech.IsoDep</tech>
        <tech>android.nfc.tech.Ndef</tech>
    </tech-list>
</resources>

2. 调整代码逻辑，确保NFC会话正确建立 #

修改你的_read方法，优化异步逻辑并确保NfcManager完全初始化后再发起请求：

_read = async () => {
  try {
    // 先检查NfcManager是否已启动，未启动则重新初始化
    const isStarted = await NfcManager.isStarted();
    if (!isStarted) {
      await NfcManager.start({
        onSessionClosedIOS: () => {
          alert('ios session closed');
        },
      });
      console.warn('NfcManager reinitialized');
    }

    // 根据平台选择合适的NFC技术，Android先尝试NfcA（MifareClassic基于NfcA）
    const tech = Platform.OS === 'ios' 
      ? NfcTech.MifareIOS 
      : NfcTech.NfcA;

    // 发起技术请求，确保会话建立
    const techResp = await NfcManager.requestTechnology(tech, {
      alertMessage: '请贴近NFC卡'
    });
    console.log('requestTechnology成功:', techResp);

    // 获取tag对象
    const tag = await NfcManager.getTag();
    console.log('获取到Tag:', tag);

    // Android平台下，切换到MifareClassic技术（如果需要）
    if (Platform.OS === 'android') {
      await NfcManager.requestTechnology(NfcTech.MifareClassic);
    }

    // 发送Mifare命令
    const cmdResp = Platform.OS === 'ios'
      ? await NfcManager.sendMifareCommandIOS([0x30, 0x00])
      : await NfcManager.transceive([0x30, 0x00]);
    console.log('命令响应:', cmdResp);

    this._cleanUp();
  } catch (ex) {
    console.warn('NFC操作失败:', ex);
    this._cleanUp();
  }
}

3. 优化componentDidMount的初始化逻辑 #

确保NfcManager启动完成后再允许用户触发读卡操作，比如添加一个状态标记：

state = {
  nfcReady: false
};

componentDidMount() {
  NfcManager.start({
    onSessionClosedIOS: () => {
      alert('ios session closed');
    },
  })
  .then(() => {
    console.warn('NfcManager started');
    this.setState({ nfcReady: true });
  })
  .catch((error) => {
    alert('Error starting NfcManager: ', error);
    this.setState({ nfcReady: false });
  });
}

// 在render中根据nfcReady状态禁用/启用读卡按钮
render() {
  return (
    <Button 
      title="读取NFC卡" 
      onPress={this._read} 
      disabled={!this.state.nfcReady}
    />
  );
}

4. Oppo设备额外注意事项 #

Oppo的ColorOS可能有严格的后台权限限制，你需要：

• 确保应用已获得NFC权限（在系统设置中手动确认）
• 关闭应用的「后台冻结」或「省电模式」，避免系统限制NFC功能

总结 #

切后台再切前台的本质是触发Android系统重新注册NFC前台调度，解决核心问题后就不需要再做这个操作。getTag()的报错是requestTechnology未成功建立会话的连锁反应，修复前者后后者自然解决。

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