第1章：adb环境与基础命令——设备连接、shell进入、权限申请与常用命令速查

现象识别：后台任务排查工作流的“入场”障碍

在着手分析 Android 后台任务（Service、JobScheduler、AlarmManager、WorkManager 等）之前，第一步永远是确认 adb 环境是否就绪。典型“卡住”现象包括：

• adb devices 输出为空或显示 unauthorized
• 执行 adb shell 后出现 error: device offline 或 permission denied
• 目标应用的后台行为日志无法通过 adb logcat 捕获
• 权限申请对话框未弹出，或设备在授权后仍不可用

这些现象本质上都是 adb 链路未建立，导致后续所有“数据采集—原因定位—修复—复测”动作无法执行，因此必须优先清除。

数据采集：adb 连接状态与权限状态取证

当怀疑 adb 环境故障时，应依次执行以下“最小数据采集”流程：

1. 主机侧检查： 运行 adb devices -l 获取完整设备列表及型号。
2. USB 连接状态： 观察设备端是否弹出“已连接 USB 调试”通知，并在开发者选项中确认“USB调试”开关状态。
3. 权限记录： 检查设备上 设置 → 开发者选项 → USB调试授权 列表，看目标计算机是否已被授权（或处于 unauthorized 状态）。
4. 快速试错命令： 依次执行以下命令，输出可用于诊断：

adb kill-server
adb start-server
adb devices -l
adb shell ls /data/local/tmp

若最后一步报 permission denied 或 device not found，说明连接或权限存在关键缺失。

adb devices -l > debug_connect.txt 2>&1

原因定位：adb 连接故障树

根据采集到的症状，对照以下故障树快速定位根因：

修复动作：分步排除与权限申请

根据故障树定位的根因，执行对应的修复步骤：

• USB 驱动缺失： 下载设备官方 USB 驱动（或使用 Google USB Driver），在设备管理器中更新驱动，然后重新插拔 USB。
• 未授权： 在设备上通过提示框“允许 USB 调试”并勾选“始终允许此计算机”。也可手动撤销授权后重试：adb kill-server && adb start-server。
• 设备 offline： 执行 adb reconnect offline，或重启 adb 服务：adb reboot（较激进）。
• 权限不足： 对非 root 设备，使用 adb shell run-as <package> 进入应用私有目录；对 root 设备先执行 adb root。
• 后台日志捕获权限： 在 adb logcat 前加 --pid=$(adb shell pidof <package>) 只抓取目标进程日志，避免信息过载。

# 授权计算机（手动弹框确认）
adb kill-server
adb start-server

# 授予 shell 超级权限（root 设备）
adb root
adb remount

# 进入目标应用进程上下文
adb shell
run com.example.app

# 查看当前有效用户 ID
adb shell id

复测：确认环境可用性

修复后，请运行以下“三连测试”确认环境就绪：

1. adb devices -l 必须输出一行 device 状态且包含传输 ID。
2. adb shell echo "OK" 必须返回 OK。
3. adb logcat -d -t 1 必须能输出至少一条日志（无空输出）。

若以上全部通过，你的 adb 环境已满足后续章节中“数据采集→原因定位→修复→复测”的所有前提。

预防：构建可复用的 adb 工作台配置

避免每次排查都重新调试环境，建议建立以下预防机制：

• 环境检查脚本： 编写 check_adb_env.sh，自动执行 adb devices、adb shell id 并检查返回状态。
• 命令速查卡片： 保存第1章的命令集合至便签或 Markdown 文件，方便快速复制。
• USB 线材专用化： 使用一条标明“仅用于 adb 调试”的数据线，避免与充电线混淆。
• 开发者选项常开： 在调试机上保持“USB调试”和“不锁定屏幕”常开，减少重复操作。

adb devices -l

adb shell

adb kill-server / adb start-server

adb root

adb shell run-as <包名>

adb logcat -d -t 1