Android应用写入NFC卡触发java.io.IOException问题求助

阿华AIGC实验室

2026-5-25

解决Android NFC写入时的IOException及NdefFormatable导入问题

刚踩过类似的坑，给你梳理下能快速排查的方向：

先搞定「导入无法解析符号」的问题

这个大概率是IDE缓存或配置小问题，按顺序排查：

确认SDK版本：NdefFormatable从API 10开始就支持了，检查Module级build.gradle里的compileSdkVersion和targetSdkVersion是不是至少在10以上（建议用30+的版本，兼容性更好）。
清理IDE缓存：Android Studio偶尔会抽风，缓存紊乱就会报红。直接点顶部菜单栏File → Invalidate Caches... → Invalidate and Restart，重启后基本能解决。

补全Manifest配置：虽然导入问题和Manifest不直接挂钩，但没声明NFC权限后续调用必报错，提前加上：

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

核对导入语句：别写错包名，正确导入是：import android.nfc.tech.NdefFormatable;

再解决`java.io.IOException`（栈指向`NdefFormatable.format()`）

日志显示异常为null是因为你没正确打印完整栈信息，以后记得用Log.e(TAG, "格式化NFC卡失败", e);来输出全部异常细节。针对这个异常，常见原因和解决方法：

1. NFC卡不支持NDEF格式化

不是所有NFC卡都能转成NDEF格式，比如MIFARE Classic卡（很多门禁卡用这种），Android原生对它的NDEF支持有限，需要厂商额外库才能操作。先换一张NFC Forum Type 2/3/4标准卡测试，排除卡的兼容性问题。

2. 卡处于只读状态或无写入权限

有些卡出厂就锁成只读，或者需要先解锁才能写入。如果是自己的卡，可以用专业NFC工具先检查读写状态，确认可写后再尝试格式化。

3. NFC连接异常

调用format()前必须确保NdefFormatable实例已成功连接，而且操作不能在主线程（会阻塞导致超时）。给你一个标准操作模板：

// 从NFC触发的Intent中获取Tag对象
Tag tag = getIntent().getParcelableExtra(NfcAdapter.EXTRA_TAG);
if (tag == null) return;

NdefFormatable ndefFormatable = NdefFormatable.get(tag);
if (ndefFormatable != null) {
    // 用AsyncTask在后台线程处理NFC操作（避免主线程阻塞）
    new AsyncTask<Void, Void, Boolean>() {
        @Override
        protected Boolean doInBackground(Void... voids) {
            try {
                ndefFormatable.connect();
                // 构造合法的NDEF消息（禁止传空消息！）
                NdefRecord textRecord = NdefRecord.createTextRecord("en", "测试NFC写入内容");
                NdefMessage message = new NdefMessage(new NdefRecord[]{textRecord});
                ndefFormatable.format(message);
                return true;
            } catch (IOException e) {
                Log.e("NFC", "格式化失败", e);
                return false;
            } finally {
                try {
                    ndefFormatable.close();
                } catch (IOException e) {
                    Log.e("NFC", "关闭连接失败", e);
                }
            }
        }

        @Override
        protected void onPostExecute(Boolean success) {
            // 回到主线程提示用户结果
            Toast.makeText(getApplicationContext(), success ? "写入成功" : "写入失败", Toast.LENGTH_SHORT).show();
        }
    }.execute();
} else {
    Toast.makeText(this, "该NFC卡不支持NDEF格式化", Toast.LENGTH_SHORT).show();
}