Flutter中USB打印机断开重连后无法打印问题

核心排查方向 #

• 会话资源释放检查：确认USB连接断开时，是否正确释放了上一次连接持有的设备权限句柄、关闭了已建立的通信端口。绝大多数系统的USB授权是绑定单次连接会话的，断开后旧授权自动失效，如果旧的设备对象引用没有被清空，系统会误判当前已持有授权，既不会弹出新的权限申请，也无法和新接入的设备建立通信。
• 权限触发逻辑检查：确认权限申请方法的调用时机，不要只在应用首次启动、第一次检测到USB设备时才触发权限申请，不要依赖系统自动弹出权限弹窗。
• 端侧配置检查：Android端核对AndroidManifest.xml中USB权限广播、设备过滤规则配置是否正确，排查Activity启动模式是否导致广播接收失效；iOS端核对Info.plist中UISupportedExternalAccessoryProtocols是否配置了打印机对应协议，是否存在应用后台挂起导致权限回调丢失的问题。
• 插件兼容性检查：如果使用第三方USB打印/通信插件，确认插件版本是否存在已知的重连逻辑缺陷，部分低版本插件不会主动监听设备断开事件，会一直持有失效的旧设备对象，导致二次接入时识别不到新设备实例。

落地解决步骤 #

• 注册全局USB连接状态监听，收到设备断开回调时主动释放所有相关资源：关闭打开的打印端口、清空本地缓存的已授权设备ID、注销之前注册的权限广播接收器，参考代码：

usbEventStream.listen((event) {
  if (event is UsbDetachEvent) {
    // 关闭已打开的通信端口
    if (printerPort != null) {
      printerPort?.close();
      printerPort = null;
    }
    // 清空本地缓存的授权标记
    _authorizedUsbDeviceId = null;
  }
});

• 每次检测到匹配VID/PID的目标打印机接入时，先主动校验当前设备的有效权限，不管之前是否完成过授权，只要权限无效就主动调用权限申请方法，权限校验通过后再建立通信、执行打印，参考代码：

// 识别到目标打印机接入
if (matchedPrinter != null) {
  // 主动校验权限
  bool validPermission = await usbManager.hasPermission(matchedPrinter);
  if (!validPermission) {
    // 主动发起权限申请
    await usbManager.requestPermission(matchedPrinter);
  }
  // 二次确认权限获取成功后再打开端口
  if (await usbManager.hasPermission(matchedPrinter)) {
    printerPort = await matchedPrinter.createPort();
    await printerPort?.open();
    // 执行打印逻辑
  }
}

• Android端补充配置：在对应启动页的Activity标签下添加USB设备接入监听和过滤规则，避免应用在后台时权限申请被系统拦截：

<intent-filter>
  <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
</intent-filter>
<meta-data
  android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
  android:resource="@xml/usb_device_filter" />

注意：需要在res/xml目录下新建usb_device_filter.xml，配置当前使用打印机对应的VID、PID，避免匹配到其他无关USB设备。

• 第三方插件异常兼容：如果升级插件到最新稳定版后仍存在问题，可以在收到USB断开回调时，主动调用插件的dispose方法销毁旧实例，再重新初始化插件，清空插件内部缓存的失效设备列表。

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