React Native NFC跨iOS与Android交互异常问题求助

问题现象 #

• iOS端调用startTechRequest后，日志输出Apple::Tag {}，能触发NFC但返回空标签对象
• Android端调用writeNdef仅打印Android::Requesting，requestTechnology无响应，后续逻辑完全未执行

修复步骤 #

1. 补全Android端NFC权限与Manifest配置 #

Android对NFC有严格的权限和声明要求，必须在AndroidManifest.xml中添加以下内容：

<!-- 基础NFC权限 -->
<uses-permission android:name="android.permission.NFC" />
<!-- Android 10+前台NFC检测权限 -->
<uses-permission android:name="android.permission.NFC_TRANSACTION_EVENT" />
<!-- 声明应用依赖NFC硬件 -->
<uses-feature android:name="android.hardware.nfc" android:required="true" />

<!-- 为处理NDEF标签添加Intent过滤（可选，用于前台触发） -->
<intent-filter>
    <action android:name="android.nfc.action.NDEF_DISCOVERED" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:mimeType="text/plain" />
</intent-filter>

注意：Android 10及以上版本，应用必须处于前台可见状态才能发起NFC请求，后台进程无法触发。

2. 重构Android端NFC请求逻辑 #

当前同时请求Ndef和NdefFormatable可能导致调度冲突，拆分逻辑并确保释放资源：

const writeNdef = async () => {
    try {
        const message = 'Hello from S24 Ultra';
        const record = Ndef.textRecord(message);
        const bytes = Ndef.encodeMessage([record]);

        console.log('Android::Requesting');

        // 先尝试写入已格式化的NDEF标签，失败后再尝试格式化空白标签
        let tech;
        try {
            tech = await NfcManager.requestTechnology(NfcTech.Ndef);
            console.log('Android::Requested Ndef');
            await NfcManager.ndefHandler.writeNdefMessage(bytes);
        } catch (ndefErr) {
            console.log('Android::Ndef请求失败，尝试格式化空白标签');
            tech = await NfcManager.requestTechnology(NfcTech.NdefFormatable);
            console.log('Android::Requested NdefFormatable');
            await NfcManager.ndefFormatableHandlerAndroid.formatNdef(bytes);
        }

        console.log('Android::Write success');
    } catch (ex) {
        console.log('Android::Write Ndef::Catch', ex);
    } finally {
        // 强制释放NFC连接，避免后续请求阻塞
        await NfcManager.cancelTechnologyRequest();
        console.log('Android::Write Ndef::Finally');
    }
};

核心修改：

• 拆分Ndef与NdefFormatable的请求逻辑，避免同时请求导致的调度异常
• 在finally块中添加cancelTechnologyRequest()，确保NFC资源被正确释放

3. 修复iOS端空标签问题 #

iOS返回空标签是因为缺少权限配置，在Info.plist中添加：

<key>NFCReaderUsageDescription</key>
<string>需要NFC权限读取和写入标签内容</string>
<key>com.apple.developer.nfc.readersession.formats</key>
<array>
    <string>NDEF</string>
</array>

同时优化代码为async/await风格，避免嵌套Promise：

const startTechRequest = async () => {
    try {
        await NfcManager.requestTechnology([NfcTech.Ndef, NfcTech.NdefFormatable]);
        const tag = await NfcManager.getTag();
        console.log('Apple::Tag', tag);
    } catch (err) {
        console.log('Apple::NFC Error', err);
    } finally {
        await NfcManager.cancelTechnologyRequest();
    }
};

4. 验证NFC标签兼容性 #

确保测试用的NFC标签支持NDEF格式，部分老旧标签仅支持Mifare等非NDEF格式，会导致Android无法识别。建议使用空白可格式化NDEF标签进行测试。

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