2026-09-12 一卡通人员全量同步防重与有界内存变更记录

变更结论

本次先处理人员全量同步重复运行和全量同步内存叠加问题，不实现“内存不足时抢占并优先保障支付”的策略。

人员同步由消费页实例级任务调整为应用进程级唯一任务。消费页创建、设置页返回和手动重试均复用同一个 ConsumptionPersonSyncController；页面销毁只解除观察者，不再中断并新建另一轮任务。

HTTP 输入流 → 单次 SAX 解析 → 1000 人分页 → 私有目录原子落盘 → 分批全量字段校验 → 分批上传业务服务器 → 可选分批写入本地人员库 → 清理临时批次

防重处理

• 新增 ConsumptionPersonSyncRuntime，在应用进程内持有唯一 Controller 和后台执行器。
• ConsumptionActivity 只附加和解除观察者；Activity 重建不会关闭后台任务。
• 自动和手动触发共用同一 AtomicBoolean 防重锁。
• 每轮重新取得当前业务服务，设置修改地址后下一轮继续生效。

内存处理

• SOAP 响应直接从输入流进行一次 SAX 解析，不再创建完整字节数组、XML 字符串或 DOM。
• 人员字段 Map 直接交接给 CustomerRecord，取消重复 Map。
• 源端恢复 1000 人分页，每页原子写入 noBackupFilesDir/onecard_person_sync_batches/<syncId>。
• CustomerFetchResult 只持有批次存储引用和统计，不持有全量人员 List。
• 业务字段先逐批完成全量校验，再逐批创建和上传最多 1000 条 DTO。
• 可选 SQLite 快照逐批读取；任务结束后清理临时批次。

验证结果

• Amazon Corretto 8（1.8.0_482）运行 :app:testDebugUnitTest：通过。
• :app:assembleDebug：通过。
• 人员分页、业务分批、脏数据预校验、SOAP 流式解析、文件批次读写、Controller 状态与本地保存相关测试均通过。
• git diff --check：通过。

真机验收项

• 设置页往返和手动重试期间只能存在一个运行中的 syncId。
• 26,200 人按 27 页拉取：前 26 页各 1000 人，末页 200 人。
• 核对 Java Heap 峰值以及本地人员保存开关开启、关闭两条路径。

Git 状态

未执行 Git 暂存、提交、推送、合并、拉取或分支切换；记录不包含人员明细或生产凭据。