Android MVP架构下NFC阅读器onNewIntent未触发问题

首先，结合你的场景梳理下核心问题：后台唤醒NFC标签正常，说明基础的NFC权限、标签识别配置没问题，问题大概率出在前台调度的生命周期绑定逻辑，或者NFCReader类里的前台调度实现缺失/错误。下面给你一步步排查和解决的方案：

一、先确认NFCReader类的前台调度逻辑是否完整 #

因为你把NFC操作封装到了实现Sensor接口的NFCReader类里，这个类必须绑定Activity的生命周期，并且正确实现前台调度的核心配置：

1. NFCReader类的核心实现示例 #

public class NFCReader implements Sensor {
    private final Activity mActivity;
    private NfcAdapter mNfcAdapter;
    private PendingIntent mPendingIntent;
    private IntentFilter[] mIntentFilters;
    private String[][] mTechLists;

    public NFCReader(Activity activity) {
        mActivity = activity;
        mNfcAdapter = NfcAdapter.getDefaultAdapter(activity);
        initForegroundDispatchConfig();
    }

    // 初始化前台调度的关键配置
    private void initForegroundDispatchConfig() {
        // 1. 创建PendingIntent：扫描到标签时，将Intent回调给当前Activity
        Intent intent = new Intent(mActivity, mActivity.getClass());
        intent.addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP);
        // Android 12+必须添加FLAG_MUTABLE，否则会抛出SecurityException
        mPendingIntent = PendingIntent.getActivity(mActivity, 0, intent, PendingIntent.FLAG_MUTABLE);

        // 2. 配置IntentFilter：过滤你需要处理的NFC事件类型
        // 这里以NDEF标签为例，可根据你的标签类型调整（比如ACTION_TECH_DISCOVERED）
        IntentFilter ndefFilter = new IntentFilter(NfcAdapter.ACTION_NDEF_DISCOVERED);
        try {
            ndefFilter.addDataType("text/plain"); // 替换成你标签的MIME类型
        } catch (MalformedMimeTypeException e) {
            throw new RuntimeException("无效的MIME类型配置", e);
        }
        mIntentFilters = new IntentFilter[]{ndefFilter};

        // 3. 配置支持的NFC技术列表（处理非NDEF标签时需要）
        mTechLists = new String[][]{
                new String[]{IsoDep.class.getName()},
                new String[]{NfcA.class.getName()}
        };
    }

    // 开启前台调度：必须在Activity的onResume中调用
    public void enableForegroundDispatch() {
        if (mNfcAdapter != null) {
            mNfcAdapter.enableForegroundDispatch(mActivity, mPendingIntent, mIntentFilters, mTechLists);
        }
    }

    // 关闭前台调度：必须在Activity的onPause中调用
    public void disableForegroundDispatch() {
        if (mNfcAdapter != null) {
            mNfcAdapter.disableForegroundDispatch(mActivity);
        }
    }

    // 处理扫描到的NFC数据：需要在Activity的onNewIntent中调用
    public void handleNfcIntent(Intent intent) {
        String action = intent.getAction();
        if (NfcAdapter.ACTION_NDEF_DISCOVERED.equals(action) ||
            NfcAdapter.ACTION_TECH_DISCOVERED.equals(action) ||
            NfcAdapter.ACTION_TAG_DISCOVERED.equals(action)) {
            // 这里写入你的标签读取逻辑
            Tag tag = intent.getParcelableExtra(NfcAdapter.EXTRA_TAG);
            // ... 解析标签数据的代码
        }
    }
}

2. 关键注意点 #

• 必须用Activity Context初始化：如果误用Application Context，前台调度会直接失效。
• PendingIntent的Flag：Android 12及以上版本必须添加PendingIntent.FLAG_MUTABLE，否则会触发权限异常。
• IntentFilter匹配度：如果你的标签是NDEF格式的URL，要对应配置Uri类型的Filter；如果是纯技术标签，要改用ACTION_TECH_DISCOVERED并配置正确的TechLists。

二、确认NFCReaderActivity的生命周期绑定是否正确 #

前台调度必须和Activity的生命周期严格同步——在onResume开启，onPause关闭，否则会被系统自动取消：

public class NFCReaderActivity extends AppCompatActivity {
    private NFCReader mNfcReader;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_nfc_reader);
        mNfcReader = new NFCReader(this);
        // 如果是MVP架构，可将mNfcReader传递给Presenter层管理
    }

    @Override
    protected void onResume() {
        super.onResume();
        // 核心：前台调度必须在Activity可见时开启
        mNfcReader.enableForegroundDispatch();
    }

    @Override
    protected void onPause() {
        super.onPause();
        // 核心：前台调度必须在Activity不可见时关闭，避免干扰其他应用
        mNfcReader.disableForegroundDispatch();
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        // 将扫描到的Intent传递给NFCReader处理
        mNfcReader.handleNfcIntent(intent);
    }
}

常见错误排查 #

1. 忘记在onResume调用enableForegroundDispatch：很多开发者会把开启逻辑放在onCreate，但Activity后台切回后，前台调度会被系统关闭，必须在onResume重新开启。
2. PendingIntent未加FLAG_ACTIVITY_SINGLE_TOP：导致每次扫描都会重新创建Activity，而不是触发onNewIntent。
3. IntentFilter不匹配标签类型：可以先临时改用最宽泛的ACTION_TAG_DISCOVERED测试，如果能触发，说明之前的过滤规则和你的标签不匹配。

三、补充测试验证步骤 #

如果上述配置后仍无响应，可以按以下步骤排查：

• 在enableForegroundDispatch方法中添加日志，确认该方法确实被调用，且mNfcAdapter不为null。
• 暂时简化IntentFilter和TechLists：

  IntentFilter tagFilter = new IntentFilter(NfcAdapter.ACTION_TAG_DISCOVERED);
  mIntentFilters = new IntentFilter[]{tagFilter};
  mTechLists = null; // 匹配所有技术类型
  

  若此时能触发，说明之前的过滤规则不匹配你的标签。
• 再次确认AndroidManifest配置（虽然后台唤醒正常，但还是要检查）：

  <uses-permission android:name="android.permission.NFC" />
  <uses-feature android:name="android.hardware.nfc" android:required="true" />
  
  <activity android:name=".NFCReaderActivity">
      <!-- 后台唤醒的IntentFilter -->
      <intent-filter>
          <action android:name="android.nfc.action.NDEF_DISCOVERED" />
          <category android:name="android.intent.category.DEFAULT" />
          <data android:mimeType="text/plain" />
      </intent-filter>
  </activity>
  

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