## AOSP 问题定位：模块边界先看现象

AOSP 问题定位：模块边界这次按新的切面重写，先锁新问题边界，再展开排查与修复。

这类故障最烦的地方在于它经常伪装成偶发成功，但真正的根因往往就藏在 一上来全局搜索导致失焦、分支版本与真机 build 不一致 这一类边界条件里。如果日志、监控、数据库状态各说各话，AOSP 问题定位 的定位就会被拉长，所以开场先把触发条件、影响范围和错误信号钉死最重要。很多团队以为自己缺的是更多代码，实际更缺的是把 AOSP 问题定位 这条链路拆成可观察节点，否则每次都像在盲调。

## AOSP 问题定位先这样修

这次方案故意避开旧文里已经写过的处理骨架，改成围绕 AOSP 问题定位 的新触发条件、新观察点和新回归步骤来组织。我会先补 建立 log tag 到源码目录的索引，再收紧 保留常用 repo branch 和 tag 速查表，最后把 先做最小可复现补丁 补齐。这个顺序的好处是改动小、回归快、证据也更容易收口。方案上不要急着推翻整条链路，先把最危险的节点单点替换掉，再用 cs.android.com 和 repo grep 把新旧行为对齐。

## AOSP 问题定位示例代码

我故意把示例压成能直接复制的大小，目标不是讲概念，而是让 Android源代码 场景能马上动手验证。如果一段代码不能直接进工程跑，一条命令不能直接拿去比对现场，那它对排障文章的价值就不够高。

1. 核心实现

repo forall framework* -c "git rev-parse --short HEAD"
repo grep -n "Timeout waiting for service" frameworks base services

2. 现场命令

adb logcat -v threadtime ActivityManager:* SystemServer:* *:S
m services/tests/servicestests

3. 兜底校验片段

data class YuandaimaCheckResult(
    val key: String,
    val ok: Boolean,
    val detail: String
)

fun verifyYuandaimaState(key: String, expected: String, actual: String): YuandaimaCheckResult {
    val ok = expected == actual
    return YuandaimaCheckResult(key, ok, if (ok) "matched" else "$expected != $actual")
}

## AOSP 问题定位常见坑

线上偶发成功不能算修好，只要还有一小批失败样本解释不通，就继续往下挖，不要提前收口。如果这篇文章是给团队复用的，最值钱的不是大道理，而是‘出现什么信号就别继续查 A，直接切去查 B’这种分叉提示。如果旧文已经把 AOSP 问题定位 讲成通用排查文章，这次就别再重复宽口径写法，直接缩到更具体的子问题与验证信号。

## 报错怎么处理

1. 状态写乱了

如果现场出现旧数据覆盖新数据、页面恢复后状态倒退，先用 cs.android.com 对齐时间线，再核对本地状态迁移是不是原子提交。把请求发出、回包落库、UI 消费三段时间顺序排清楚，根因通常会自己浮出来。

adb logcat -v threadtime ActivityManager:* SystemServer:* *:S
m services/tests/servicestests

2. 任务重复执行

如果后台恢复、重试或多入口并发后任务跑了两次，优先补幂等键、唯一调度名和入口锁，再回头核对 保留常用 repo branch 和 tag 速查表 有没有被真正收紧。别只看业务日志，还要确认调度层是不是只进了一次。

fun yuandaimaWorkName(id: String): String {
    return "yuandaima-$id"
}

fun shouldSkipYuandaima(running: Boolean, hasPending: Boolean): Boolean {
    return running || hasPending
}

## 命令和代码直接跑

真正有价值的最小样例，必须保留最短入口、最少依赖和明确输出，这样复现、修复、回归三步才能连起来。只要先稳定复现一次，再把修复版稳定跑通一次，文章就不是经验笔记，而是可执行模板。最小可运行片段也不再沿用旧文那套标题/首段/代码锚点，而是直接验证这次新切面的根因。

1. 最小数据结构

data class YuandaimaState(
    val id: String,
    val status: String,
    val updatedAt: Long,
    val source: String
)

2. 本地跑一遍

fun runYuandaimaDemo() {
    val state = YuandaimaState("42", "pending", System.currentTimeMillis(), "yuandaima")
    println(state)
}

3. 最小验证命令

adb logcat -v threadtime ActivityManager:* SystemServer:* *:S
m services/tests/servicestests
adb logcat -d | findstr /I "Exception timeout retry"