flutter_usb_printer在Android12/13设备USB热敏打印支票异常问题

这个故障的核心触发点是你用的USB打印库旧版本没有适配Android 12+的系统规则，在Pixel系列原生系统上会触发系统级拦截，和打印指令本身无关：

• Android 12开始强制要求所有涉及设备权限申请的PendingIntent必须添加FLAG_IMMUTABLE标记，旧版本库用的无标记可变PendingIntent，在系统回调权限结果时会直接抛出安全异常，触发系统进程兜底拉起锁屏/桌面，就是你看到的授权后自动锁屏再解锁的现象
• Pixel原生系统对USB外设的操作线程做了限制，旧版本库在权限广播的后台线程里直接初始化USB连接、下发打印指令，会被系统判定为无权限后台操作外设，直接拦截所有后续打印请求，表现为打印机完全无响应。

你可以根据项目迭代成本二选一，不需要硬换库，也不需要改核心打印业务逻辑。

方案1：现有库适配修复（改动成本最低） #

只需要改3处原生配置和逻辑，就能解决Pixel设备上的兼容问题：

1. 补全AndroidManifest.xml的适配项
   打开项目安卓目录下的AndroidManifest.xml，补全权限声明、给USB广播接收器配置12+要求的导出属性：

   <!-- Android 12+ 必需的USB操作权限 -->
   <uses-permission android:name="android.permission.USB_PERMISSION" />
   <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" android:maxSdkVersion="33" />
   
   <receiver
       android:name="com.example.flutter_usb_printer.USBReceiver"
       android:exported="false">
       <intent-filter>
           <action android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED" />
           <action android:name="android.hardware.usb.action.USB_PERMISSION" />
       </intent-filter>
       <meta-data
           android:name="android.hardware.usb.action.USB_DEVICE_ATTACHED"
           android:resource="@xml/device_filter" />
   </receiver>
   

2. 修正PendingIntent标记
   找到插件内申请USB权限的原生代码段，把原来无标记的PendingIntent创建逻辑替换为适配高版本系统的写法：

   val flags = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
       PendingIntent.FLAG_IMMUTABLE
   } else {
       PendingIntent.FLAG_UPDATE_CURRENT
   }
   val permissionIntent = PendingIntent.getBroadcast(context, ACTION_USB_PERMISSION_REQUEST_CODE, intent, flags)
   

3. 调整打印触发时机
   不要在收到USB权限授权的广播回调里直接执行连接、打印操作，把这部分逻辑延后到应用回到前台状态再执行：监听Flutter的App生命周期回调，等AppLifecycleState变为resumed之后再初始化USB连接、下发打印指令，避开Pixel系统对后台线程操作外设的拦截。

方案2：替换维护更活跃的打印库（长期维护成本更低） #

如果不想自己维护插件原生代码，可以替换为近1年有版本更新、明确标注适配Android 13/14的USB热敏打印库，这类新版本库已经默认处理了PendingIntent标记、组件导出、操作线程调度的适配问题，不需要手动修改原生代码，替换后只需要校验下你用的支票打印ESC/POS指令（走纸、切纸、文字排版、印章打印）兼容即可。

额外排查提示：Pixel设备如果开启了USB调试的「始终允许当前设备调试」开关，会和USB外设的权限申请逻辑冲突，测试时可以先关掉USB调试的永久授权，排除调试模式带来的干扰。

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