Android NFC跨设备发送ICAO指令异常，Oppo返回0x6A88错误如何排查？

问题背景 #

我正在开发一款面向Android设备的NFC库，用于符合ICAO标准的护照和身份证读取功能。目前在LG等部分设备上发送指令可以正常返回携带0x9000的有效响应，但在Oppo等部分设备上运行异常。

我发送的十六进制示例指令为：0082000028523A9AE020BF2B637771344671E7A444DABDE99BBE84835F5B1552963D69623B3DD77D609A3A22E628

发送该指令前执行的步骤：

• 发送指令：0x00, 0xA4, 0x04, 0x0C, 0x07, 0xA0, 0x00, 0x00, 0x02, 0x47, 0x10, 0x01
• 发送指令：0x00, 0x84, 0x00, 0x00, 0x08
• 第三步为触发错误的指令

错误信息 #

Oppo设备上返回错误码为0x6A88，Logcat日志如下：

2021-07-26 15:11:51.982 994-4950/? D/NxpTml: PN54X - Write requested.....
2021-07-26 15:11:51.982 994-4950/? D/NxpTml: PN54X - Invoking I2C Write.....
2021-07-26 15:11:51.985 994-4949/? D/NxpTml: PN54X - I2C Read successful.....
2021-07-26 15:11:51.985 994-4949/? D/NxpTml: Delay Read if write thread is busy
2021-07-26 15:11:51.985 994-4950/? D/NxpNciX: len =  49 > 00002E0082000028523A9AE020BF2B637771344671E7A444DABDE99BBE84835F5B1552963D69623B3DD77D609A3A22E628
2021-07-26 15:11:51.985 994-4950/? D/NxpTml: PN54X - I2C Write successful.....
2021-07-26 15:11:51.985 994-4950/? D/NxpTml: PN54X - Posting Fresh Write message.....
2021-07-26 15:11:51.985 994-4950/? D/NxpTml: PN54X - Tml Writer Thread Running................

相同Android版本的其他品牌设备运行正常，目前无法定位问题，需要排查是否和发送数据大小有关，或者Manifest需要添加额外配置。

补充信息 #

现有NFCAdapter配置代码如下：

val adapter = NfcAdapter.getDefaultAdapter(this)
if (adapter != null) {
    val intent = Intent(applicationContext, this.javaClass)
    intent.flags = Intent.FLAG_ACTIVITY_SINGLE_TOP
    val pendingIntent =
        PendingIntent.getActivity(this, 0, intent, PendingIntent.FLAG_UPDATE_CURRENT)
    val filter = arrayOf(arrayOf("android.nfc.tech.IsoDep"))
    adapter.enableForegroundDispatch(this, pendingIntent, null, filter)
}

目前正在尝试改用enableReaderMode配置，暂时存在标签无法识别的问题，后续会更新进展。

问题排查与解决方案 #

首先明确0x6A88的标准含义：ISO 7816规范中该错误码对应「未找到引用数据」，结合复现场景，大概率是设备厂商的NFC栈实现差异导致的问题，可按以下优先级排查：

1. 调整IsoDep超时参数
   不同厂商的NFC芯片默认超时阈值不同，NXP芯片在部分Oppo机型上默认的超时时间无法满足长APDU指令的交互要求。可以在获取到IsoDep实例后，手动调用setTimeout()方法，将超时值调整到1000ms以上，再重新发送指令测试。
2. APDU指令分片处理
   当前发送的第三步指令长度为49字节，部分厂商的NFC栈对超过特定长度的APDU指令处理逻辑存在差异，可以尝试将指令拆分为短APDU，按照链形APDU的规则分片发送，验证是否能规避错误。
3. 修复ReaderMode配置
   你当前使用的enableForegroundDispatch模式在部分定制ROM上存在卡片信号被系统NFC服务拦截的问题，改用enableReaderMode是正确的方向，无法识别标签大概率是参数配置错误：需要确保FLAG_READER_NFC_A和FLAG_READER_SKIP_NDEF_CHECK两个标志位都开启，同时禁用平台默认的NDEF检查，避免系统抢占卡片交互通道。
4. 核对Manifest配置
   除了基础的android.permission.NFC权限外，需要确认是否添加了android.hardware.nfc的feature声明，部分定制ROM会对未声明对应feature的应用限制NFC指令的发送权限。
5. 校验密钥协商流程
   第三步指令是双向认证的指令，部分厂商的NFC栈会对密钥协商过程中的随机数校验逻辑做定制修改，可以核对第二步0x84指令获取的随机数是否在Oppo设备上能正常被后续逻辑处理，是否存在字节序被篡改的问题。

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