2026-09-14 一卡通 Windows 报文字节格式对齐变更记录

变更结论

Android 一卡通 SOAP 请求中可由应用稳定控制的部分，已按 2026-09-12 Windows Charles 成功抓包对齐。消费金额、卡片流水、余额、计数、TAC、PSAM 流水和请求时间等交易数据仍取真实业务值，没有伪造或固定。

已对齐内容

• SOAP 请求体不再输出 XML 声明。
• soap:Envelope 命名空间按 Windows 顺序输出：soap、xsi、xsd、soapenc，并补充 soapenc 命名空间。
• 非 ASCII 字符按 Windows ATL 格式输出为大写十六进制字符实体；Description 的“上机支出”输出为 上机支出。
• xsi:nil="1" 空标签去掉 /> 前的空格。
• 所有一卡通 SOAP 请求显式设置 User-Agent: Microsoft-ATL-Native/7.00。
• Windows 成功样本的 UploadBusinessRec 请求体回归断言为 UTF-8 精确 1933 字节。

未强制对齐内容

• Content-Length 继续根据每次真实 UTF-8 请求体动态计算，不能固定为 Windows 样例的 1933。
• Host 继续由实际 WebService 地址生成。
• HTTP 请求头在线路中的最终顺序及系统自动头由 Android HttpURLConnection 管理，不依赖顺序做业务兼容。
• DTO 字段值、采集时间和交易时间仍来自真实消费记录，本次只调整序列化外形和客户端标识。

代码与测试

• SoapRequestFactory：统一 Windows 兼容的 SOAP Envelope、字符实体和空标签格式；协议命名空间使用具名常量，并补充兼容原因注释。
• OnecardWebServiceClient：集中设置可控 SOAP 请求头，使用具名常量配置 Windows ATL User-Agent。
• OnecardUploadSoapRequestTest：增加 XML 声明、命名空间顺序、字符实体、空标签和 1933 字节断言。
• OnecardWebServiceClientTest：增加实际请求头配置的 User-Agent 回归断言。

TDD 与验证

• RED：JDK 8 下新请求体测试在原实现的 XML 声明处失败。
• GREEN：请求体兼容实现后，Windows 样例测试通过并精确为 1933 字节。
• RED：新增请求头测试因缺少 configureRequestHeaders 而编译失败。
• GREEN：请求头配置接入真实发送路径后，两项兼容测试通过。
• JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash ./gradlew --no-daemon :app:testDebugUnitTest --tests 'com.zhct.traybinding.onecard.server.*'：成功。
• JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash ./gradlew --no-daemon :app:assembleDebug：成功。
• 将固定样例生成结果与归档 Windows 原始请求体逐字节比较：双方均为 1933 字节，byteExact=true。
• 全量 :app:testDebugUnitTest 共运行 205 项，其中 3 项现有客户分页测试失败：生产常量已是每页 2000，测试仍按每页 1000 断言；相关分页实现和测试文件均无本次 diff。

现场边界

本次未连接 Android 设备，也未对新 APK 做 Charles/Windows 双端实抓复核。自动化已经锁定应用生成的请求体和显式请求头；最终系统自动头与线路字节仍建议设备重新连接后抓取一次确认。

Git 边界

本次未执行暂存、提交、推送、拉取、分支切换或其他 Git 写操作，也未修改提示词仓库中用户已有的未提交内容。