fix(reconnect): 上一次会话的关闭码污染下一次会话（v0.2.1）+ 重连链路的真实 WebSocket 集成测试
ReconnectPolicyTest（11 项）验的是**纯函数**「给定关闭码应该怎么退避」，而 ⑦
「连接频繁重连」的缺陷往往出在**调用点**。新增 PoseWebSocketReconnectTest（8 项）：
用 MockWebServer.withWebSocketUpgrade 在 JVM 上起**真实** WebSocket 服务端
（能按 §3.2 回 welcome、按 §3.6 回 pong、按指定关闭码关连接），无需设备即可覆盖
「该重连的」与「不该重连的」两条分支。Robolectric 只用来提供 android.os.Build 桩。
它抓到的真实缺陷（本版修复）：
上一次会话的关闭码会污染下一次会话，导致重新开始推流后失去自动重连能力。
复现：第一次连接被对端以 1001 关闭（按 §7 不重连，正确）→ 用户再点「开始推流」
→ 这一次是网络层失败（服务端还没起来），按 §7 **应当**重连 → 但 connect() 只重置了
reconnectCounter 与 lastPongAtMs，**没有清 lastCloseCode** → scheduleReconnect()
仍按 1001 判定 → 直接 stopped，**再也不会自动重连**。
测试失败信息（修复前）：
✗ 上一次 1001 关闭后重新连接，遇到网络失败仍应按策略重连
AssertionError: 当前 state=STOPPED，lastCloseCode=1001，attempts=0
修复（PoseWebSocketClient.kt）：
* connect()：清掉会话级关闭状态（lastCloseCode=0、lastCloseReason=""）；
* onFailure()：记录 recordClose(0, …)（契约 §7 中 0=未收到关闭帧 → 应重连），
顺带让界面「最近一次断开原因」显示本次失败而不是旧值。
用例清单：握手→streaming 与 welcome 保活参数解析、按协商间隔发 ping 收 pong、
1011 按退避重连且等待落在策略 ±20% 区间、成功后计数清零、1001/1002 不重连、
主动断开不重连、上一次 1001 后再连遇网络失败仍应重连（本次回归锁）、
服务端未启动时 1.5s 内 ≤3 次尝试（退避生效）。
实测：./gradlew :app:testDebugUnitTest → 6 个测试类 / 64 项用例 / 0 失败
（原 56 项）；build/verify.sh 全绿（签名、APK 版本元数据 0.2.1/201、native 库体检、
ABI、R8、dex）。版本号 0.2.0/200 → 0.2.1/201。
踩坑：第一版 MockWebServer 夹具的 101 响应没有回显 Sec-WebSocket-Protocol
（RFC 6455 要求），客户端记录的 negotiatedProtocol 为空导致断言失败 —— 那是
**夹具**不合规而非客户端问题，已在夹具里补上。写「真实对端」夹具时要按 RFC/契约
把服务端做对，否则会把夹具缺陷误判成产品缺陷。
This commit is contained in:
@@ -9,20 +9,41 @@ OpenDance Studio **阶段三**: Android 辅助 App(Kotlin + CameraX + MediaPipe
|
||||
|
||||
## 状态
|
||||
|
||||
**阶段三已完成**: T-AND-001 -> T-AND-013 全部落地（含重连状态机、MediaPipe 崩溃修复、APK 产物版本元数据校验）。
|
||||
**阶段三已完成**: T-AND-001 -> T-AND-016 全部落地（含重连状态机与**真实 WebSocket 重连链路测试**、MediaPipe 崩溃修复、APK 产物版本元数据校验、native 库体检）。
|
||||
|
||||
| 验收项 | 结果 |
|
||||
|--|--|
|
||||
| 单元测试 | OK **56 项全部通过**(JVM，无需设备；新增重连策略与 MediaPipe 诊断用例) |
|
||||
| 单元测试 | OK **64 项全部通过**(JVM，无需设备；含 MockWebServer 真实 WebSocket 的重连链路集成测试) |
|
||||
| **跨端金标准** | OK Kotlin 序列化器与 Web 端 TypeScript 实现**逐位一致** |
|
||||
| `./gradlew assembleRelease` | OK 生成**已签名** APK(28.6 MB) |
|
||||
| 签名校验 | OK `apksigner` 退出码 0, v2 方案，CN=OpenDance Studio Dev |
|
||||
| 包信息 | OK `com.opendance.studio` v0.2.0, minSdk 29(Android 10+)/ targetSdk 34 |
|
||||
| 包信息 | OK `com.opendance.studio` v0.2.1 (versionCode 201), minSdk 29(Android 10+)/ targetSdk 34 |
|
||||
| 模型随包分发 | OK `assets/pose_landmarker_lite.task` 5.7 MB(Stored 未压缩) |
|
||||
| ABI 覆盖 | OK arm64-v8a + armeabi-v7a(debug 额外含 x86/x86_64) |
|
||||
| APK 版本元数据 | OK 直接读产物 `AndroidManifest` 的 `versionName=0.2.0`/`versionCode=200`，与 `project.yaml` 一致（T-AND-013） |
|
||||
| APK 版本元数据 | OK 直接读产物 `AndroidManifest` 的 `versionName=0.2.1`/`versionCode=201`，与 `project.yaml` 一致（T-AND-013） |
|
||||
| native 库体检 | OK ELF 类型匹配双 ABI、`DT_NEEDED` 闭包完整（无缺失依赖）、`PT_LOAD` 页对齐 `0x4000`（16 KB 页兼容）、`zipalign -P 16` 通过（T-AND-015） |
|
||||
|
||||
## v0.2.1 修订（重连链路的真实 WebSocket 集成测试 + 一处真实缺陷）
|
||||
|
||||
**缺陷**：上一次会话的关闭码会**污染下一次会话**，导致重新开始推流后失去自动重连能力。
|
||||
复现路径：第一次连接被对端以 `1001` 关闭（按契约 §7 **不重连**，正确）→ 用户再次点
|
||||
「开始推流」→ 这一次是**网络层失败**（服务端还没起来），按 §7 **应当**重连 →
|
||||
但 `connect()` 只重置了重连计数与 pong 时间，**没有清 `lastCloseCode`**，
|
||||
`scheduleReconnect()` 仍按 1001 判定 → 直接 `stopped`，**再也不会自动重连**。
|
||||
|
||||
**修复**：`connect()` 清掉会话级关闭状态（`lastCloseCode = 0`、`lastCloseReason = ""`）；
|
||||
`onFailure()` 记录 `recordClose(0, …)`（0 = 未收到关闭帧 → 应重连），
|
||||
顺带让界面「最近一次断开原因」显示本次失败而不是旧值。
|
||||
|
||||
**为什么之前没发现**：`ReconnectPolicyTest`（11 项）验的是**纯函数**「给定关闭码怎么退避」，
|
||||
而缺陷在**调用点**（关闭码没被正确重置）。新增
|
||||
`app/src/test/java/com/opendance/studio/PoseWebSocketReconnectTest.kt`（8 项）：
|
||||
用 `MockWebServer.withWebSocketUpgrade` 在 JVM 上起**真实** WebSocket 服务端，
|
||||
覆盖「该重连的」（1011 / 服务器未启动）与「不该重连的」（1000/1001/1002 / 主动断开）两条分支，
|
||||
并断言重连等待取自策略且落在 ±20% 区间、成功后计数清零。
|
||||
|
||||
```
|
||||
|
||||
## 快速开始
|
||||
|
||||
```bash
|
||||
@@ -261,7 +282,7 @@ app/src/main/java/com/opendance/studio/
|
||||
问题大多出在 native 库打包上，而这几项**无设备也能查**：
|
||||
|
||||
```bash
|
||||
python3 build/check_native_libs.py dist-release/opendance-android-v0.2.0/app-release.apk
|
||||
python3 build/check_native_libs.py dist-release/opendance-android-v0.2.1/app-release.apk
|
||||
# -> 每个 ABI 下每个 .so 的 ELF 类型 / DT_NEEDED 闭包 / PT_LOAD 页对齐
|
||||
# -> ✓ native 库体检通过：arm64-v8a, armeabi-v7a ｜ ELF 类型匹配、依赖闭包完整、16 KB 页对齐
|
||||
```
|
||||
@@ -274,7 +295,7 @@ python3 build/check_native_libs.py dist-release/opendance-android-v0.2.0/app-rel
|
||||
而用户装的是 zip 里的 `app-release.apk`。发布前对包再跑一次：
|
||||
|
||||
```bash
|
||||
bash build/accept-release.sh dist-release/opendance-android-v0.2.0.zip
|
||||
bash build/accept-release.sh dist-release/opendance-android-v0.2.1.zip
|
||||
# -> sha256 / 文件清单 / AndroidManifest versionName+versionCode / ABI+MediaPipe native
|
||||
# / 模型资源 / dex 中的 PoseLandmarker / 验签 / 包内契约快照与仓库一致
|
||||
# -> 发布包级验收全部通过
|
||||
@@ -285,13 +306,13 @@ bash build/accept-release.sh dist-release/opendance-android-v0.2.0.zip
|
||||
|
||||
**产物侧复核（T-AND-013）**：`versionName` 是**构建配置**，而安装界面 / 应用信息页 /
|
||||
`dumpsys package` 读的是 **APK 的 `AndroidManifest`**。构建缓存、复用旧 APK、
|
||||
打包时拷错文件都会造成「配置全对、产物是旧版」，配置层校验抓不到（Windows 端
|
||||
v0.2.1 就踩过同类坑）。因此新增：
|
||||
打包时拷错文件都会造成「配置全对、产物是旧版」，配置层校验抓不到（**Windows 客户端**
|
||||
的 v0.2.1 就踩过同类坑：配置文件全一致，exe 属性页显示 0.1.0）。因此新增：
|
||||
|
||||
```bash
|
||||
bash build/check-apk-version.sh app/build/outputs/apk/release/app-release.apk
|
||||
# -> AndroidManifest versionName = 0.2.0 / versionCode = 200
|
||||
# -> ✓ APK 版本元数据一致：0.2.0（versionCode 200）
|
||||
# -> AndroidManifest versionName = 0.2.1 / versionCode = 201
|
||||
# -> ✓ APK 版本元数据一致：0.2.1（versionCode 201）
|
||||
```
|
||||
|
||||
`build/check_apk_version.py` 直接解析二进制 AXML，**不需要 Android SDK / aapt2**
|
||||
|
||||
Reference in New Issue
Block a user