优卡特扫码串口单读取线程修复记录

记录日期：2026-08-26

项目仓库：/Users/liang/AndroidStudioProjects/CusumptionMachine

实施分支：simplify_menu_pay

问题现象

菜单消费账单核对弹框关闭后再次打开，扫码器可能连续响多次，但前几次没有发起支付。现场日志确认三次扫码分别由三个不同线程读取，前两个线程属于已经关闭业务回调、但仍阻塞在串口 read() 的旧实例；数据被旧线程消费后直接丢弃，第三次才由当前账单会话处理。

优卡特扫码器原实现中，每个页面或弹框都会重新打开 /dev/ttyS3 并创建读取线程。关闭时虽然调用了 interrupt() 和串口关闭，但设备驱动无法保证立即唤醒阻塞中的 InputStream.read()。旧线程可能继续等待并与新线程竞争后续扫码数据。

新增进程级 YoukateQrcodePortManager，作为 /dev/ttyS3 的唯一物理串口所有者，进程内只创建一个读取线程。
YoukateQrcodeSerialPortScanner 改为轻量业务会话，不再直接打开或关闭物理串口；支持 resume()、pause() 和永久 close()。
新增 LatestSessionDispatcher，最后注册的页面获得当前会话所有权；旧会话关闭不会清除新会话。
读取线程捕获会话后在主线程投递前再次校验会话编号，弹框关闭或页面切换期间已经排队的迟到结果会被丢弃。
串口读取异常由唯一管理器串行重连，重连期间禁止创建第二个读取线程。
自由消费、定额消费及无键盘版本将硬件初始化和释放统一到 onStart()/onStop()。
订单核销和出餐核销在进入前台时恢复优卡特扫码会话，进入后台时暂停会话。
原优卡特扫码弹框补充 onStop() 兜底释放会话和停止倒计时。
菜单账单弹框继续沿用现有资源释放出口，但关闭动作现在只注销当前扫码会话，不再关闭物理串口。

app/src/main/java/com/cpt/cusumption/devices/serial/LatestSessionDispatcher.java
app/src/main/java/com/cpt/cusumption/devices/youkate/YoukateQrcodePortManager.java
app/src/main/java/com/cpt/cusumption/devices/youkate/YoukateQrcodeSerialPortScanner.java
app/src/main/java/com/cpt/cusumption/activity/FreeActivity.java
app/src/main/java/com/cpt/cusumption/activity/FreeNoKeyboardActivity.java
app/src/main/java/com/cpt/cusumption/activity/QuotaActivity.java
app/src/main/java/com/cpt/cusumption/activity/QuotaNoKeyboardActivity.java
app/src/main/java/com/cpt/cusumption/activity/OrderVerifyActivity.java
app/src/main/java/com/cpt/cusumption/activity/MealServedActivity.java
app/src/main/java/com/cpt/cusumption/view/YoukateQrcodeScanPop.java
app/src/main/java/com/cpt/cusumption/view/MenuBillCheckPop.java
app/src/test/java/com/cpt/cusumption/devices/serial/LatestSessionDispatcherTest.java

按 TDD 先运行 LatestSessionDispatcherTest，确认生产类缺失时测试编译失败。
实现后 LatestSessionDispatcherTest 共 4 个测试全部通过，覆盖最后会话独占、旧会话关闭不影响新会话、会话替换后丢弃排队结果、当前会话关闭后拒绝迟到结果。
JAVA_HOME=/Users/liang/Library/Java/JavaVirtualMachines/corretto-1.8.0_482/Contents/Home bash gradlew :app:testDebugUnitTest :app:assembleDebug：通过，BUILD SUCCESSFUL。
当前支付模块与扫码会话模块共 9 个相关单元测试，失败数和错误数均为 0。
Debug APK：app/build/outputs/apk/debug/app-debug.apk。