APP未运行/后台时NFC触发GraphQL查询失效，求解决方案

1. 正确配置NFC Intent Filter（核心步骤） #

要让未启动/后台的APP被NFC事件唤醒，必须在AndroidManifest.xml中给处理NFC的Activity配置高优先级的Intent Filter，确保系统优先触发你的APP而非默认应用：

• 给Activity设置android:launchMode="singleTop"，避免重复启动实例；
• 添加DEFAULT类别，让系统能将NFC隐式Intent传递到你的APP；
• 优先使用NDEF_DISCOVERED过滤器（系统优先级最高），搭配自定义MIME类型或AAR记录；
• 可选添加TECH_DISCOVERED过滤器，覆盖无NDEF数据的标签场景。

示例配置：

<activity
    android:name=".NfcHandlerActivity"
    android:launchMode="singleTop">
    <!-- 针对带自定义MIME的NDEF标签 -->
    <intent-filter>
        <action android:name="android.nfc.action.NDEF_DISCOVERED" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:mimeType="application/com.your.app.nfc" />
    </intent-filter>
    <!-- 针对无NDEF数据的标签 -->
    <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>

nfc_tech_filter.xml示例（放在res/xml目录）：

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

2. 用Android Application Record（AAR）锁定标签 #

如果能控制NFC标签的写入，直接在标签的NDEF消息中添加AAR记录，指定你的APP包名。这是系统级机制，优先级高于所有默认应用，能确保无论APP是否运行，系统都会直接启动你的APP处理标签。

写入AAR的代码示例：

NdefRecord aarRecord = NdefRecord.createApplicationRecord("com.your.app.package");
NdefMessage message = new NdefMessage(new NdefRecord[]{aarRecord});
// 将message写入标签的逻辑（需处理标签连接、写入等流程）

3. Android 10+后台NFC监听方案 #

Android 10及以上版本限制了后台应用的NFC访问权限，需配合前台服务实现后台监听：

• 在AndroidManifest.xml中申请FOREGROUND_SERVICE和NFC权限；
• 创建前台服务，在服务中初始化NfcAdapter并设置ReaderCallback，启动前台服务时必须显示通知；
• 未启动的APP需先通过NFC Intent唤醒Activity，再由Activity启动前台服务维持监听。

服务核心逻辑示例：

public class NfcBackgroundService extends Service {
    private NfcAdapter mNfcAdapter;
    private final NfcAdapter.ReaderCallback mReaderCallback = tag -> {
        // 在这里执行GraphQL查询和更新操作
    };

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        // 启动前台服务（必须显示通知）
        Notification notification = buildForegroundNotification();
        startForeground(1001, notification);

        mNfcAdapter = NfcAdapter.getDefaultAdapter(this);
        if (mNfcAdapter != null) {
            Bundle options = new Bundle();
            options.putInt(NfcAdapter.EXTRA_READER_PRESENCE_CHECK_DELAY, 250);
            mNfcAdapter.enableReaderMode(this, mReaderCallback,
                    NfcAdapter.FLAG_READER_NFC_A | NfcAdapter.FLAG_READER_NFC_B |
                    NfcAdapter.FLAG_READER_SKIP_NDEF_CHECK, options);
        }
        return START_STICKY;
    }

    // 构建前台通知的方法（略）
    private Notification buildForegroundNotification() {
        // 实现通知创建逻辑
    }
}

4. 处理三星设备特殊情况 #

三星默认NFC应用优先级较高，除了上述配置，可引导用户手动设置默认应用：

• 系统设置路径：设置 -> 连接 -> NFC和支付 -> 默认应用 -> 选择你的APP；
• 在APP内添加引导步骤，告知用户如何设置，避免每次弹出默认应用。

5. 排查BroadcastReceiver失效原因 #

你之前的BroadcastReceiver方案失效，大概率是因为：

• Android 8.0+禁止静态注册接收NFC隐式广播（如android.nfc.action.TAG_DISCOVERED），必须动态注册；
• 动态注册仅在组件（Activity/Service）活跃时生效，适合配合前台服务使用。

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