当前位置：首页 > news >正文

HarmonyOS 6学习：NFC服务中IsoDep连接失败的排查与解决——从参数匹配到多SDK协同的完整指南

news 2026/6/6 13:03:29

在HarmonyOS 6应用开发中，NFC（近场通信）功能为移动支付、门禁模拟、信息交换等场景提供了便捷的解决方案。然而，开发者在实现与ISO-DEP（ISO/IEC 14443-4）类型NFC标签的交互时，常会遇到一个棘手问题：调用getIsoDep()方法建立连接时，系统抛出错误，导致应用无法正常读取或写入标签数据。本文将深入剖析这一问题的根源，并提供从基础排查到高级架构设计的完整解决方案。

一、问题现象：连接失败的报错信息

当应用尝试与支持ISO-DEP协议的NFC标签（如大多数银行卡、交通卡）建立连接时，开发者可能会在日志中看到如下错误：

2024-07-15 10:30:25.456 E/NfcService: connectTech() failed with error code: 0x80100001 2024-07-15 10:30:25.457 E/MyNfcApp: Failed to connect to IsoDep tag: TECH_NOT_SUPPORTED 2024-07-15 10:30:25.458 E/MyNfcApp: java.lang.IllegalArgumentException: Tag doesn't support ISO-DEP technology

更具体的错误场景通常发生在以下代码段执行时：

import { tag, nfc } from '@kit.ConnectivityKit'; // 监听NFC标签发现 tag.on('discover', (tagInfo: tag.TagInfo) => { try { // 尝试获取IsoDep对象 const isoDep: nfc.IsoDep = tag.getIsoDep(tagInfo); // 尝试连接标签 isoDep.connect().then(() => { console.log('Connected to ISO-DEP tag successfully'); // 发送APDU指令 return isoDep.transmit([0x00, 0xA4, 0x04, 0x00, 0x0E, 0x32, 0x50, 0x41, 0x59, 0x2E, 0x53, 0x59, 0x53, 0x2E, 0x44, 0x44, 0x46, 0x30, 0x31]); }).then((response: number[]) => { console.log('APDU response:', response); }).catch((error: Error) => { console.error('ISO-DEP operation failed:', error); }); } catch (error) { console.error('Failed to get IsoDep instance:', error); } });

上述代码在遇到不支持ISO-DEP技术的标签时，会在tag.getIsoDep()或isoDep.connect()阶段抛出异常，导致整个NFC交互流程中断。

二、背景知识：NFC技术类型与ISO-DEP协议

要理解这个问题，首先需要了解NFC标签的多种技术类型：

1. NFC技术类型体系

HarmonyOS NFC框架支持多种NFC技术标准，主要包括：

NFC-A (ISO/IEC 14443 Type A)：最常见的类型，用于公交卡、门禁卡等
NFC-B (ISO/IEC 14443 Type B)：用于身份证、部分银行卡
NFC-F (FeliCa)：日本常用的标准，如Suica卡
NFC-V (ISO/IEC 15693)：用于物流追踪、资产管理
ISO-DEP (ISO/IEC 14443-4)：在NFC-A或NFC-B之上构建的数据交换协议
NDEF (NFC Data Exchange Format)：NFC论坛定义的数据格式标准
MIFARE Classic：恩智浦的专有技术
MIFARE Ultralight：低成本NFC标签技术

2. ISO-DEP协议的特殊性

ISO-DEP不是一种独立的物理层技术，而是建立在NFC-A或NFC-B基础之上的传输层协议。这意味着：

依赖关系：ISO-DEP标签必须首先支持NFC-A或NFC-B
协议封装：ISO-DEP在底层技术之上添加了数据包分割、错误检测等机制
应用场景：主要用于金融支付（EMV）、交通卡等需要安全通信的场景

3. HarmonyOS NFC架构

HarmonyOS的NFC服务采用分层架构：

应用层 (Application) ↓ NFC服务框架 (NFC Service Framework) ↓ HAL层 (Hardware Abstraction Layer) ↓ NFC控制器驱动 (NFC Controller Driver) ↓ 物理NFC芯片 (NFC Hardware)

当应用调用tag.getIsoDep()时，系统会：

检查标签的TagInfo中是否包含ISO_DEP技术类型
验证底层NFC控制器是否支持该协议
创建相应的IsoDep对象实例
建立与标签的通信链路

三、问题根因分析：为什么IsoDep连接会失败？

根据华为官方文档和实际开发经验，IsoDep连接失败通常由以下原因导致：

1. 技术类型不匹配（最常见原因）

这是最普遍的问题。开发者误以为所有NFC标签都支持ISO-DEP，但实际上只有特定类型的标签才支持。

// 错误示例：假设所有标签都支持ISO-DEP tag.on('discover', (tagInfo: tag.TagInfo) => { // 没有检查技术类型就直接调用getIsoDep() const isoDep = tag.getIsoDep(tagInfo); // 可能抛出异常 }); // 正确做法：先检查技术类型 tag.on('discover', (tagInfo: tag.TagInfo) => { console.log('Discovered tag with technologies:', tagInfo.techList); // 检查是否支持ISO_DEP if (tagInfo.techList.includes(tag.NFC_ISO_DEP)) { const isoDep = tag.getIsoDep(tagInfo); // 继续处理ISO-DEP标签 } else { console.log('Tag does not support ISO-DEP technology'); // 处理其他类型的标签 } });

2. 标签参数与接口要求不匹配

即使标签支持ISO-DEP，如果参数配置不正确，连接仍可能失败：

// 可能的参数问题 const tagInfo: tag.TagInfo = { tagId: new Uint8Array([0x04, 0x08, 0x15, 0x16, 0x23, 0x42]), techList: [tag.NFC_A, tag.NFC_ISO_DEP], // 支持NFC-A和ISO-DEP // 缺少必要的扩展参数可能导致连接失败 }; // 需要确保标签信息完整 try { // 某些标签可能需要额外的ATQA/SAK信息 const extendedInfo = tag.getExtendedInfo(tagInfo); console.log('Extended tag info:', extendedInfo); } catch (error) { console.error('Failed to get extended tag info:', error); }

3. 多SDK环境下的监听冲突

在复杂的应用架构中，多个SDK可能都需要处理NFC事件，但HarmonyOS的NFC事件监听机制存在限制：

// ❌ 错误示例：多个模块独立注册监听 // SDK1中的代码 import { tag } from '@kit.ConnectivityKit'; tag.on('discover', (tagInfo) => { console.log('SDK1: Tag discovered'); // 处理逻辑1 }); // SDK2中的代码（同一应用内） import { tag } from '@kit.ConnectivityKit'; tag.on('discover', (tagInfo) => { console.log('SDK2: Tag discovered'); // 处理逻辑2 - 可能覆盖SDK1的监听器 }); // 结果：只有最后注册的监听器生效

4. 权限与配置问题

应用可能缺少必要的NFC权限或配置：

// module.json5配置检查 { "module": { "requestPermissions": [ { "name": "ohos.permission.NFC", // NFC权限 "reason": "用于读取NFC标签" }, { "name": "ohos.permission.NFC_TAG", // NFC标签操作权限 "reason": "用于与NFC标签通信" } ], "abilities": [ { "skills": [ { "actions": [ "ohos.nfc.tag.TAG_FOUND" // NFC标签发现意图 ], "uris": [ { "scheme": "nfc", "host": "tag" } ] } ] } ] } }

四、解决方案：从基础排查到架构优化

方案一：完整的技术类型检查与兼容处理

建立健壮的NFC标签处理流程，确保对各种技术类型的兼容性：

import { tag, nfc } from '@kit.ConnectivityKit'; class NFCTagHandler { private tagInfo: tag.TagInfo | null = null; // 处理发现的标签 public handleDiscoveredTag(tagInfo: tag.TagInfo): void { this.tagInfo = tagInfo; console.log('=== NFC Tag Discovered ==='); console.log('Tag ID:', this.formatTagId(tagInfo.tagId)); console.log('Supported technologies:', this.getTechnologyNames(tagInfo.techList)); // 根据技术类型分发处理 this.dispatchByTechnology(tagInfo); } // 格式化标签ID private formatTagId(tagId: Uint8Array): string { return Array.from(tagId) .map(byte => byte.toString(16).padStart(2, '0')) .join(':'); } // 获取技术类型名称 private getTechnologyNames(techList: number[]): string[] { const techMap: { [key: number]: string } = { [tag.NFC_A]: 'NFC-A (ISO/IEC 14443-3A)', [tag.NFC_B]: 'NFC-B (ISO/IEC 14443-3B)', [tag.NFC_F]: 'NFC-F (FeliCa)', [tag.NFC_V]: 'NFC-V (ISO/IEC 15693)', [tag.NFC_ISO_DEP]: 'ISO-DEP (ISO/IEC 14443-4)', [tag.NFC_NDEF]: 'NDEF (NFC Data Exchange Format)', [tag.NFC_MIFARE_CLASSIC]: 'MIFARE Classic', [tag.NFC_MIFARE_ULTRALIGHT]: 'MIFARE Ultralight', }; return techList.map(tech => techMap[tech] || `Unknown (0x${tech.toString(16)})`); } // 根据技术类型分发处理 private dispatchByTechnology(tagInfo: tag.TagInfo): void { const techList = tagInfo.techList; // 检查ISO-DEP if (techList.includes(tag.NFC_ISO_DEP)) { this.handleIsoDepTag(tagInfo); return; } // 检查NDEF if (techList.includes(tag.NFC_NDEF)) { this.handleNdefTag(tagInfo); return; } // 检查其他技术类型 if (techList.includes(tag.NFC_A)) { this.handleNfcATag(tagInfo); } else if (techList.includes(tag.NFC_B)) { this.handleNfcBTag(tagInfo); } else if (techList.includes(tag.NFC_F)) { this.handleNfcFTag(tagInfo); } else if (techList.includes(tag.NFC_V)) { this.handleNfcVTag(tagInfo); } else { console.warn('Unsupported NFC technology combination'); this.handleUnknownTag(tagInfo); } } // 处理ISO-DEP标签 private async handleIsoDepTag(tagInfo: tag.TagInfo): Promise<void> { console.log('Processing ISO-DEP tag...'); try { // 获取IsoDep实例 const isoDep: nfc.IsoDep = tag.getIsoDep(tagInfo); // 配置连接参数 const connectOptions: nfc.ConnectOptions = { timeout: 5000, // 5秒超时 // 其他可选参数... }; // 建立连接 await isoDep.connect(connectOptions); console.log('ISO-DEP connection established successfully'); // 发送SELECT APDU命令 const selectCommand = new Uint8Array([ 0x00, 0xA4, 0x04, 0x00, // SELECT命令 0x0E, // 数据长度：14字节 0x32, 0x50, 0x41, 0x59, // "2PAY" 0x2E, 0x53, 0x59, 0x53, // ".SYS" 0x2E, 0x44, 0x44, 0x46, // ".DDF" 0x30, 0x31 // "01" ]); const response = await isoDep.transmit(selectCommand); console.log('SELECT APDU response:', this.formatApduResponse(response)); // 根据响应处理后续逻辑 if (response.length >= 2 && response[response.length - 2] === 0x90 && response[response.length - 1] === 0x00) { console.log('SELECT command successful'); await this.processPaymentApplication(isoDep); } else { console.warn('SELECT command failed, trying other AIDs...'); await this.tryAlternativeAIDs(isoDep); } // 断开连接 isoDep.close(); console.log('ISO-DEP connection closed'); } catch (error) { console.error('Failed to handle ISO-DEP tag:', error); // 错误分类处理 if (error instanceof Error) { if (error.message.includes('TECH_NOT_SUPPORTED')) { console.error('Tag does not actually support ISO-DEP technology'); this.fallbackToBasicNfc(tagInfo); } else if (error.message.includes('IO_ERROR')) { console.error('I/O error during communication'); this.retryWithDifferentParameters(tagInfo); } else if (error.message.includes('TIMEOUT')) { console.error('Connection timeout'); this.handleTimeout(tagInfo); } else { console.error('Unknown error:', error.message); } } } } // 格式化APDU响应 private formatApduResponse(response: number[]): string { if (!response || response.length === 0) { return 'Empty response'; } const hexString = response.map(byte => byte.toString(16).padStart(2, '0')).join(' '); const statusWord = response.length >= 2 ? `SW: ${response[response.length - 2].toString(16).padStart(2, '0')}${response[response.length - 1].toString(16).padStart(2, '0')}` : 'No status word'; return `Bytes: ${hexString} | ${statusWord}`; } // 处理支付应用 private async processPaymentApplication(isoDep: nfc.IsoDep): Promise<void> { console.log('Processing payment application...'); // 实现具体的支付逻辑 // 例如：读取余额、交易记录等 } // 尝试其他AID private async tryAlternativeAIDs(isoDep: nfc.IsoDep): Promise<void> { const alternativeAIDs = [ [0xA0, 0x00, 0x00, 0x03, 0x33, 0x01, 0x01, 0x01], // 通用支付AID [0xA0, 0x00, 0x00, 0x03, 0x33, 0x02, 0x01, 0x01], // 电子钱包AID // 添加更多AID... ]; for (const aid of alternativeAIDs) { try { const selectCommand = new Uint8Array([ 0x00, 0xA4, 0x04, 0x00, aid.length, ...aid ]); const response = await isoDep.transmit(selectCommand); if (response.length >= 2 && response[response.length - 2] === 0x90 && response[response.length - 1] === 0x00) { console.log(`Found application with AID: ${aid.map(b => b.toString(16).padStart(2, '0')).join('')}`); break; } } catch (error) { console.warn(`Failed with AID: ${aid.map(b => b.toString(16).padStart(2, '0')).join('')}`); } } } // 回退到基础NFC处理 private fallbackToBasicNfc(tagInfo: tag.TagInfo): void { console.log('Falling back to basic NFC handling...'); // 实现基础NFC处理逻辑 } // 使用不同参数重试 private retryWithDifferentParameters(tagInfo: tag.TagInfo): void { console.log('Retrying with different parameters...'); // 实现重试逻辑 } // 处理超时 private handleTimeout(tagInfo: tag.TagInfo): void { console.log('Handling timeout...'); // 实现超时处理逻辑 } // 处理NDEF标签 private handleNdefTag(tagInfo: tag.TagInfo): void { console.log('Processing NDEF tag...'); // 实现NDEF处理逻辑 } // 处理其他NFC类型... private handleNfcATag(tagInfo: tag.TagInfo): void { console.log('Processing NFC-A tag...'); } private handleNfcBTag(tagInfo: tag.TagInfo): void { console.log('Processing NFC-B tag...'); } private handleNfcFTag(tagInfo: tag.TagInfo): void { console.log('Processing NFC-F tag...'); } private handleNfcVTag(tagInfo: tag.TagInfo): void { console.log('Processing NFC-V tag...'); } private handleUnknownTag(tagInfo: tag.TagInfo): void { console.log('Processing unknown tag type...'); } } // 使用示例 const nfcHandler = new NFCTagHandler(); // 注册NFC发现监听 tag.on('discover', (tagInfo: tag.TagInfo) => { nfcHandler.handleDiscoveredTag(tagInfo); }); // 开始扫描 tag.startDiscovery().then(() => { console.log('NFC discovery started'); }).catch((error: Error) => { console.error('Failed to start NFC discovery:', error); });

方案二：多SDK环境下的协同处理架构

针对多个SDK都需要处理NFC事件的场景，设计统一的事件分发机制：

// NFC事件协调器 - 统一管理所有NFC事件 import { tag } from '@kit.ConnectivityKit'; type NFCEventHandler = (tagInfo: tag.TagInfo) => void | Promise<void>; class NFCEventCoordinator { private static instance: NFCEventCoordinator; private handlers: NFCEventHandler[] = []; private isInitialized: boolean = false; // 单例模式 private constructor() {} public static getInstance(): NFCEventCoordinator { if (!NFCEventCoordinator.instance) { NFCEventCoordinator.instance = new NFCEventCoordinator(); } return NFCEventCoordinator.instance; } // 初始化NFC监听 public async initialize(): Promise<void> { if (this.isInitialized) { return; } try { // 检查NFC可用性 const nfcManager = tag.getNfcController(); const isEnabled = await nfcManager.isNfcEnabled(); if (!isEnabled) { console.warn('NFC is not enabled on the device'); // 可以提示用户开启NFC return; } // 注册统一的NFC发现监听 tag.on('discover', async (tagInfo: tag.TagInfo) => { console.log(`[Coordinator] NFC tag discovered, dispatching to ${this.handlers.length} handlers`); // 顺序执行所有注册的处理函数 for (const handler of this.handlers) { try { await Promise.resolve(handler(tagInfo)); } catch (error) { console.error(`[Coordinator] Handler execution failed:`, error); // 继续执行其他处理器，不中断流程 } } }); // 开始发现标签 await tag.startDiscovery(); this.isInitialized = true; console.log('[Coordinator] NFC event coordinator initialized successfully'); } catch (error) { console.error('[Coordinator] Failed to initialize NFC:', error); throw error; } } // 注册事件处理器 public registerHandler(handler: NFCEventHandler): string { const handlerId = `handler_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`; this.handlers.push(handler); console.log(`[Coordinator] Handler registered: ${handlerId}`); return handlerId; } // 注销事件处理器 public unregisterHandler(handlerId: string): boolean { // 在实际实现中，需要维护handler与ID的映射关系 console.log(`[Coordinator] Handler unregistered: ${handlerId}`); return true; } // 获取已注册的处理器数量 public getHandlerCount(): number { return this.handlers.length; } // 清理所有处理器 public cleanup(): void { this.handlers = []; this.isInitialized = false; console.log('[Coordinator] All handlers cleaned up'); } } // SDK1: 支付处理模块 class PaymentSDK { private handlerId: string | null = null; public initialize(): void { const coordinator = NFCEventCoordinator.getInstance(); // 注册支付相关的NFC处理器 const paymentHandler: NFCEventHandler = async (tagInfo: tag.TagInfo) => { console.log('[PaymentSDK] Processing tag for payment...'); // 检查是否支持ISO-DEP if (tagInfo.techList.includes(tag.NFC_ISO_DEP)) { try { const isoDep = tag.getIsoDep(tagInfo); await isoDep.connect(); // 支付相关处理逻辑 await this.processPayment(isoDep); isoDep.close(); } catch (error) { console.error('[PaymentSDK] Payment processing failed:', error); } } }; this.handlerId = coordinator.registerHandler(paymentHandler); console.log('[PaymentSDK] Payment handler registered'); } private async processPayment(isoDep: any): Promise<void> { // 实现具体的支付逻辑 console.log('[PaymentSDK] Processing payment transaction...'); // 模拟支付处理 await new Promise(resolve => setTimeout(resolve, 1000)); console.log('[PaymentSDK] Payment completed'); } public cleanup(): void { if (this.handlerId) { const coordinator = NFCEventCoordinator.getInstance(); coordinator.unregisterHandler(this.handlerId); this.handlerId = null; } } } // SDK2: 门禁卡模拟模块 class AccessControlSDK { private handlerId: string | null = null; public initialize(): void { const coordinator = NFCEventCoordinator.getInstance(); // 注册门禁相关的NFC处理器 const accessControlHandler: NFCEventHandler = async (tagInfo: tag.TagInfo) => { console.log('[AccessControlSDK] Processing tag for access control...'); // 检查是否支持MIFARE Classic（常见门禁卡类型） if (tagInfo.techList.includes(tag.NFC_MIFARE_CLASSIC)) { try { // 门禁卡模拟逻辑 await this.emulateAccessCard(tagInfo); } catch (error) { console.error('[AccessControlSDK] Access control processing failed:', error); } } }; this.handlerId = coordinator.registerHandler(accessControlHandler); console.log('[AccessControlSDK] Access control handler registered'); } private async emulateAccessCard(tagInfo: tag.TagInfo): Promise<void> { // 实现门禁卡模拟逻辑 console.log('[AccessControlSDK] Emulating access card...'); // 模拟门禁验证 await new Promise(resolve => setTimeout(resolve, 500)); console.log('[AccessControlSDK] Access granted'); } public cleanup(): void { if (this.handlerId) { const coordinator = NFCEventCoordinator.getInstance(); coordinator.unregisterHandler(this.handlerId); this.handlerId = null; } } } // SDK3: 数据交换模块 class DataExchangeSDK { private handlerId: string | null = null; public initialize(): void { const coordinator = NFCEventCoordinator.getInstance(); // 注册数据交换相关的NFC处理器 const dataExchangeHandler: NFCEventHandler = async (tagInfo: tag.TagInfo) => { console.log('[DataExchangeSDK] Processing tag for data exchange...'); // 检查是否支持NDEF（数据交换格式） if (tagInfo.techList.includes(tag.NFC_NDEF)) { try { // 数据交换逻辑 await this.exchangeData(tagInfo); } catch (error) { console.error('[DataExchangeSDK] Data exchange failed:', error); } } }; this.handlerId = coordinator.registerHandler(dataExchangeHandler); console.log('[DataExchangeSDK] Data exchange handler registered'); } private async exchangeData(tagInfo: tag.TagInfo): Promise<void> { // 实现数据交换逻辑 console.log('[DataExchangeSDK] Exchanging data with tag...'); // 模拟数据交换 await new Promise(resolve => setTimeout(resolve, 800)); console.log('[DataExchangeSDK] Data exchange completed'); } public cleanup(): void { if (this.handlerId) { const coordinator = NFCEventCoordinator.getInstance(); coordinator.unregisterHandler(this.handlerId); this.handlerId = null; } } } // 主应用入口 class MyNFCAplication { private paymentSDK: PaymentSDK; private accessControlSDK: AccessControlSDK; private dataExchangeSDK: DataExchangeSDK; constructor() { this.paymentSDK = new PaymentSDK(); this.accessControlSDK = new AccessControlSDK(); this.dataExchangeSDK = new DataExchangeSDK(); } public async start(): Promise<void> { console.log('=== Starting NFC Application ==='); try { // 初始化协调器 const coordinator = NFCEventCoordinator.getInstance(); await coordinator.initialize(); // 初始化各个SDK this.paymentSDK.initialize(); this.accessControlSDK.initialize(); this.dataExchangeSDK.initialize(); console.log(`Total handlers registered: ${coordinator.getHandlerCount()}`); console.log('Application ready. Bring NFC tag close to device...'); } catch (error) { console.error('Failed to start NFC application:', error); } } public stop(): void { console.log('=== Stopping NFC Application ==='); // 清理各个SDK this.paymentSDK.cleanup(); this.accessControlSDK.cleanup(); this.dataExchangeSDK.cleanup(); // 清理协调器 const coordinator = NFCEventCoordinator.getInstance(); coordinator.cleanup(); console.log('NFC application stopped'); } } // 使用示例 const app = new MyNFCAplication(); // 启动应用 app.start().then(() => { console.log('NFC application started successfully'); }); // 在适当的时机停止应用 // app.stop();

方案三：高级错误处理与重试机制

针对不稳定的NFC连接环境，实现智能重试和错误恢复：

class SmartNFCConnector { private maxRetries: number = 3; private retryDelay: number = 100; // 毫秒 private connectionTimeout: number = 5000; // 5秒 // 智能连接ISO-DEP标签 public async connectToIsoDepWithRetry(tagInfo: tag.TagInfo): Promise<nfc.IsoDep | null> { console.log(`Attempting to connect to ISO-DEP tag (max ${this.maxRetries} retries)`); for (let attempt = 1; attempt <= this.maxRetries; attempt++) { console.log(`Connection attempt ${attempt}/${this.maxRetries}`); try { const isoDep = tag.getIsoDep(tagInfo); // 设置超时 const timeoutPromise = new Promise<never>((_, reject) => { setTimeout(() => reject(new Error('Connection timeout')), this.connectionTimeout); }); // 尝试连接 const connectPromise = isoDep.connect(); await Promise.race([connectPromise, timeoutPromise]); console.log(`Connection successful on attempt ${attempt}`); return isoDep; } catch (error) { console.error(`Attempt ${attempt} failed:`, error.message); if (attempt < this.maxRetries) { // 等待一段时间后重试 await this.delay(this.retryDelay * attempt); // 指数退避 // 根据错误类型调整策略 if (error.message.includes('TECH_NOT_SUPPORTED')) { // 技术不支持，无需重试 console.log('Tag does not support ISO-DEP, stopping retries'); break; } else if (error.message.includes('IO_ERROR')) { // I/O错误，调整参数重试 console.log('I/O error detected, adjusting parameters for next attempt'); this.adjustConnectionParameters(); } } } } console.error(`Failed to connect after ${this.maxRetries} attempts`); return null; } // 延迟函数 private delay(ms: number): Promise<void> { return new Promise(resolve => setTimeout(resolve, ms)); } // 调整连接参数 private adjustConnectionParameters(): void { // 在实际实现中，可以调整超时时间、重试间隔等参数 this.retryDelay = Math.min(this.retryDelay * 1.5, 1000); // 最大1秒 console.log(`Adjusted retry delay to ${this.retryDelay}ms`); } // 诊断连接问题 public diagnoseConnectionIssue(tagInfo: tag.TagInfo): string { const issues: string[] = []; // 检查技术类型 if (!tagInfo.techList.includes(tag.NFC_ISO_DEP)) { issues.push('Tag does not support ISO-DEP technology'); } // 检查标签ID if (!tagInfo.tagId || tagInfo.tagId.length === 0) { issues.push('Tag ID is empty or invalid'); } // 检查NFC状态 this.checkNFCStatus().then(status => { if (!status.isEnabled) { issues.push('NFC is disabled on device'); } if (!status.isSupported) { issues.push('Device does not support NFC'); } }); if (issues.length === 0) { return 'No obvious issues detected. Check physical connection and tag compatibility.'; } else { return `Detected issues:\n${issues.map((issue, index) => ` ${index + 1}. ${issue}`).join('\n')}`; } } // 检查NFC状态 private async checkNFCStatus(): Promise<{ isEnabled: boolean; isSupported: boolean }> { try { const nfcManager = tag.getNfcController(); const isEnabled = await nfcManager.isNfcEnabled(); const isSupported = await nfcManager.isNfcSupported(); return { isEnabled, isSupported }; } catch (error) { console.error('Failed to check NFC status:', error); return { isEnabled: false, isSupported: false }; } } } // 使用智能连接器 const smartConnector = new SmartNFCConnector(); tag.on('discover', async (tagInfo: tag.TagInfo) => { if (tagInfo.techList.includes(tag.NFC_ISO_DEP)) { // 诊断问题 const diagnosis = smartConnector.diagnoseConnectionIssue(tagInfo); console.log('Connection diagnosis:', diagnosis); // 尝试连接 const isoDep = await smartConnector.connectToIsoDepWithRetry(tagInfo); if (isoDep) { console.log('Successfully connected to ISO-DEP tag'); // 进行后续操作 isoDep.close(); } else { console.error('Failed to connect to ISO-DEP tag after all retries'); } } });