Skip to content

fix(android): 登录轮询看门狗 + 趋势峰值 dayLabel 崩溃修复(真机 QA 发现) - #28

Merged
Qiyuanqiii merged 2 commits into
mainfrom
fix/android-login-watchdog-daylabel-v2
Aug 16, 2026
Merged

Qiyuanqiii merged 2 commits into
mainfrom
fix/android-login-watchdog-daylabel-v2

Conversation

@Qiyuanqiii

Copy link
Copy Markdown
Member

描述

真机 QA(#16)连续发现的第二个、第三个崩溃,同批修复(基于当前 main 重建分支,替代因冲突关闭的 #27):

1. 登录轮询被丢失的回调永久卡死(状态冻结在「尚未就绪」)

  • 现象:WebView 内登录成功后,localStorage 已含有效 userToken({"value":"<64字符 Bearer>"} 结构),但 App 状态永远停在「尚未就绪,等待登录完成…」;
  • 根因:evaluateJavascript 回调在页面导航期间可能被丢弃 → isChecking 永久为 true → 后续轮询全部早退;
  • 修复:checkToken / validate 引入代数(generation)+ postDelayed 看门狗(5s / 90s)——回调丢失时自动复位,下一轮询周期(1.5s)重试;过期回调按代数丢弃,避免串扰。与 fix(android): 修复点击登录的空指针崩溃(轮询 Timer 初始化顺序) #26 的字段顺序修复正确合并(状态字段位于 init 之前)。

2. 登录成功后主页趋势图崩溃(ParseException)

java.text.ParseException: Unparseable date: "16"
    at com.deepseek.meter.app.HomeScreenKt.dayLabel(HomeScreen.kt:412)
  • 根因:dailyEntries 返回的 key 是「日」数字("16",供图表坐标标签),而峰值标签 dayLabel 用 yyyy-MM-dd 解析它(A3 遗留,首次真机有数据才暴露);
  • 修复:dayLabel 兼容日数字 key(按当月渲染「8月16日」)与完整日期 key。

附带说明

  • 登录提取逻辑本身无需改动:tokenCandidates 的 unwrap() 已正确处理新版 {"value":…} 结构(真机 + CDP 同源验证通过:unwrap 后的候选对 /users/current 返回 code 0)。

验证

  • 真机已验证:修复版 APK 上手动 Token 校验成功、主页余额/用量/趋势/峰值标签全部正常渲染;看门狗版 APK 已装真机(pm install),登录后 10 秒内自动完成提取(待合并后复测确认)。

关联

变更类型

  • 🐛 Bug 修复

边界检查

  • 未引入任何第三方依赖
  • 未改动平台接口契约
  • 未夹带真实 Token 或凭据
  • 未提交构建产物
  • 未改变 Token 存储方式(保持 UserDefaults)
  • 注释与文案中文
  • 提交信息符合 Conventional Commits + 中文描述

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

一句话总结

本次 PR 修复了 Android 端两个真机 QA 发现的问题:登录轮询看门狗防止回调丢失导致永久卡死,以及趋势图 dayLabel 对纯数字日期 key 的解析崩溃。

🔴 红线 / 严重问题

未发现触碰红线的问题。改动仅涉及 Android 端(android/ 目录),未引入第三方依赖、未改动 Token 存储方式、未臆造平台接口、未破坏 CI。

🟡 建议改进

  1. android/core/src/main/java/.../TokenLoginWebView.kt:234-238 — 看门狗复位逻辑存在竞态窗口
    postDelayed 的 5000ms 看门狗与 evaluateJavascript 回调之间存在竞态:如果回调在 4999ms 时到达并设置 isChecking = false,但看门狗在 5000ms 时触发且 gen == checkGeneration(因为回调没有递增代数),会错误地将 isChecking 复位为 false。虽然这不影响正确性(只是提前结束检查),但建议在回调中递增 checkGeneration 来彻底避免竞态:

    evaluateJavascript(js) { result ->
        checkGeneration++  // 使看门狗失效
        if (gen != checkGeneration) return@evaluateJavascript
        ...
    }
  2. android/core/src/main/java/.../TokenLoginWebView.kt:277-281 — 90 秒看门狗时间过长
    注释说明校验链路最长约 90 秒,但看门狗设为 90000ms 意味着用户可能等待 90 秒才看到失败。建议考虑缩短看门狗时间(如 30-45 秒),或在校验开始时向用户显示进度提示,避免用户误以为应用卡死。

  3. android/core/src/main/java/.../dayLabel.kt:411-416 — 日历初始化可复用
    每次调用 dayLabel 都创建新的 Calendar 实例,且 cal.set(Calendar.DAY_OF_MONTH, dayOnly) 未设置年份和月份,可能导致跨年/跨月时日期计算错误。建议:

    val cal = Calendar.getInstance()
    cal.set(Calendar.YEAR, 2026)  // 或从 dateKey 解析年份
    cal.set(Calendar.MONTH, 当月索引)
    cal.set(Calendar.DAY_OF_MONTH, dayOnly)

🔵 小问题 / 风格

  1. android/core/src/main/java/.../dayLabel.kt:411 — 注释中日期格式与代码不一致
    注释写的是 "2026-08-16",但 dayFormatter 的实际格式需要确认。如果 dayFormatter 是 yyyy-MM-dd,建议在注释中明确说明,避免后续维护者混淆。

  2. android/core/src/main/java/.../TokenLoginWebView.kt:234 — 魔法数字 5000 和 90000
    建议提取为具名常量(如 CHECK_WATCHDOG_TIMEOUT_MS = 5000L 和 VALIDATE_WATCHDOG_TIMEOUT_MS = 90000L),提高可读性和可维护性。

  3. android/core/src/main/java/.../TokenLoginWebView.kt:236 — postDelayed 未取消
    如果 TokenLoginWebView 被销毁(如用户关闭登录页),postDelayed 的回调仍会执行。建议在 onDetachedFromWindow 或 destroy() 中取消所有待执行的 postDelayed。

审查结论

改动方向正确,针对真机 QA 发现的两个问题给出了合理的修复方案。看门狗机制有效解决了回调丢失导致的卡死问题,dayLabel 的兼容处理也避免了崩溃。建议按上述改进意见优化竞态处理和代码可维护性后合并。

@Qiyuanqiii
Qiyuanqiii merged commit 4c95cf3 into main Aug 16, 2026
5 checks passed
@Qiyuanqiii
Qiyuanqiii deleted the fix/android-login-watchdog-daylabel-v2 branch August 16, 2026 16:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant