PC681 称体接收缓存竞态修复方案

日期：2026-07-31
状态：已实施，待实机压力验收

结论

在无法修改 DeviceSDK-80.1.10.12.20260129.aar 的前提下，主页进入后台时不再停止或重建 SDK 接收线程，也不再直接修改 SDK 的 mReadThread、mCacheLen 和 isListening。应用只解绑业务监听器，返回主页时重新绑定监听器并复用原接收线程。

该方案从应用侧移除了导致 mCacheLen 被并发改成 -29 的写入路径，同时保留设置页通过现有串口输出流发送红外命令的能力。

问题背景

目标版本为 2.3.5，设备为 Android 11、arm64-v8a。核心崩溃为：

ArrayIndexOutOfBoundsException: dstPos=-29 length=1024
PC681ScaleManager.addDataToCache(...)

• SDK 使用 1024 字节数组和 mCacheLen 管理串口缓存。
• 一帧最小长度为 29 字节，解析后执行“缓存长度减帧长度”。
• 原 pause() 与 SDK 接收线程并发清零缓存，可产生 0 - 29 = -29。

约束

• 厂家 AAR 当前无法修改或重新发布。
• stopListening() 会关闭输入输出流，设置页需要保留输出流。
• release() 存在 JNI 字段契约风险，不能用于普通页面切换。
• 页面切换只需停止业务消费，不需要关闭硬件。

决策

1. HomeActivity.onStop() 继续调用封装层 pause()。
2. pause() 只将 hardwareListener 置空。
3. SDK 监听标记、接收线程、缓存长度和串口流保持不变。
4. 回调发现监听为空时立即返回。
5. 返回主页后重新绑定业务监听，并复用原 SDK 线程。

hardwareListener 增加 volatile，保证跨线程绑定和解绑的可见性。

替代方案

• 修改 AAR：是根治方向，但当前不具备重新发布条件。
• 中断并等待接收线程：页面切换无需关闭硬件，且会引入等待、超时和旧线程残留处理。
• 捕获异常后重启：只能容灾，不能消除竞态。
• 调用 release：会破坏设置页命令通道，并存在 JNI fatal 风险。

实现范围

• 监听器字段增加 volatile。
• pause() 改为只解绑业务监听。
• 新增 YoukateHardwareManagerPauseTest 回归测试。

未修改 AAR、主页业务流程、设置页命令协议或资源文件。

测试与验证

回归测试在旧实现上先失败，失败点为旧 pause() 修改了 SDK 监听状态；修改后同一定向测试通过。

JAVA_HOME=$(/usr/libexec/java_home -v 1.8) \
./gradlew --no-daemon :app:testDebugUnitTest :app:assembleDebug --console=plain

结果：BUILD SUCCESSFUL in 38s。本地单元测试 13 项，0 失败、0 错误、0 跳过；Debug APK 已生成。

风险与边界

• 页面离开期间 SDK 线程继续读取和解析数据，但不会进入主页业务处理。
• 显式调试入口的真正断开硬件流程不属于本次页面切换修复范围。
• 真实串口线程调度仍需目标设备压力验证。

实机验收

1. 保持秤体 50ms 或 100ms 连续输出，主页与设置页连续切换至少 100 次。
2. 覆盖快速切换、Home 键前后台切换和息屏恢复。
3. 确认不再出现 dstPos=-29 崩溃。
4. 确认红外命令仍可发送，返回主页后称重和扫码正常且无重复回调。

验收结果

代码回归测试、全量单元测试和 Debug 构建已通过。硬件并发时序无法由本地 JVM 完整模拟，最终结论需实机压力测试确认。