dumpsys dropbox
唯讀平台用來存放當機、ANR 與 tombstone 的環形緩衝——這是不用 root 讀 ANR 追蹤的方法。
- 指令
- adb shell dumpsys dropbox
- 指令
- 系統服務（dumpsys）
- 風險
- 唯讀
語法
dumpsys dropbox [--print <tag>]旗標與參數
| token | 意義 |
|---|---|
| --print <tag> | 印出那個 tag 底下每一筆的完整內容。不給 tag 就只有索引，而你該先看的正是索引。 |
範例
dumpsys dropbox索引：一筆一行，不含內容。很便宜。
dumpsys dropbox --print data_app_anr實際的 ANR 追蹤，含堆疊。
dumpsys dropbox --print data_app_crash近期 app 的當機與它們的例外。
輸出怎麼讀
輸出範例
Drop box contents: 96 entries
Max entries: 1000
2026-07-26 11:04:31 data_app_crash (text, 4321 bytes)
2026-07-26 11:41:02 data_app_anr (compressed text, 12043 bytes)
2026-07-26 12:00:00 SYSTEM_TOMBSTONE (data, 91234 bytes)索引是時間戳、tag，加上一段關於這筆資料怎麼存的括號說明。tag 就是分類：`data_app_*` 是使用者安裝的 app、`system_app_*` 是預載的、`*_anr` 是無回應的追蹤、`*_crash` 是 Java 例外、`*_native_crash` 與 `SYSTEM_TOMBSTONE` 是原生層的當機。括號裡是自由格式，廠商會改寫它。
輸出欄位
| 欄位 | 意義 |
|---|---|
| Drop box contents: N entries | 緩衝目前存了幾筆。 |
| <date> <time> <tag> | 以裝置自己的時區表示的發生時間，以及是哪一類失敗。 |
| (text, N bytes) | 儲存形式與大小。讀不到的大小是未知，不是零。 |
| data_app_anr | 使用者安裝的 app 發生的 ANR——就是你原本要去 /data/anr 找的那份追蹤。 |
| SYSTEM_TOMBSTONE | 系統決定留下來的原生層當機。 |
需要什麼權限
只要一條已授權的 `adb` 連線就夠了——不用 root、不用 `adb root`、不用 `su`，開發者選項裡除了 USB 偵錯本身也沒有其他開關要打開。這個指令會走到 `DropBoxManagerService.dump`，而它的第一行就是 `DumpUtils.checkDumpAndUsageStatsPermission(getContext(), TAG, pw)`，所以把關的是 `android.permission.DUMP` 加上 `android:get_usage_stats` 這個 app-op——而 `shell` 使用者所屬的套件 `com.android.shell`，在自己的資訊清單裡就同時拿到了 `android.permission.DUMP` 與 `android.permission.PACKAGE_USAGE_STATS`。這種不對稱正是這一頁存在的理由：drop box 是透過 shell 本來就有的權限讀出來的，而 `/data/anr` 靠的是檔案權限，那個 shell 沒有，所以同一份追蹤走一條路拿得到、走另一條路拿不到。訊息從哪個串流出來，帶出兩個實務後果。被拒絕的訊息是寫進 dump 自己那個 `PrintWriter` 的，所以它會混在你的資料裡出現在 stdout 而不是 stderr，於是一支只 grep tag 的腳本就只會什麼都找不到，然後宣布這支手機很健康。但 `dumpsys` 自己那行 service not found 卻是走 stderr。兩個串流都留著，而且在相信一份很短的答案之前，先讀它的第一行。
失敗訊息對照
| 訊息 | 意義 |
|---|---|
| Permission Denial: can't dump DropBoxManagerService from from pid=4021, uid=2000 due to missing android.permission.DUMP permission | `DumpUtils.checkDumpPermission` 組出這一行然後回傳 false，於是 `dump` 在列出任何一筆之前就停了。那個重複的 `from from` 是上游自己的錯字，如果你要比對這一行，它是有意義的——照抄，不要幫它改。在一般手機上這代表有東西把 `android.permission.DUMP` 從 `com.android.shell` 拿掉了，而不是緩衝是空的。它走的是 dump 自己的 writer，所以你會在 stdout 上和其他東西混在一起看到它。 |
| Can't find service: dropbox | `dumpsys` 向 service manager 要 `dropbox`，什麼都沒拿到，於是回傳 `NAME_NOT_FOUND`，連服務都沒呼叫。裝置還在開機、`system_server` 還沒把服務登記上去的時候，這是預期中的。這一行是寫到 stderr 的，所以把 stderr 丟掉的擷取方式，看到的會是一次空白但看起來很成功的執行。 |
| (No entries found.) | 服務回答了，但沒有東西符合。`dump` 走到最後發現符合計數還是零就會印這一行，剛刷完機的手機、以及你自己下的日期或 tag 篩選沒中，都算在裡面。它是一個真正的答案而不是錯誤：在斷定這台裝置從來沒當過機之前，先檢查你的篩選條件。 |
| (contents lost) | 索引還記得這一筆，但它的內容不見了：那筆記錄帶著 `IS_EMPTY` 旗標，`dump` 直接跳到下一筆。對那個 tag 下 `--print` 會拿到一堆標頭、底下沒有堆疊。常見原因是緩衝為了不超過容量上限而修剪檔案，而且沒有任何東西救得回來——當機紀錄要盡早收，不要拖。 |
| *** SERVICE 'dropbox' DUMP TIMEOUT (10000ms) EXPIRED *** | `dumpsys` 等不下去了。十秒是它內建的預算，`-t <seconds>` 可以調高；在開機好幾週的手機上對一個很忙的 tag 下 `--print`，是最實際會撞到它的方式。你手上已經有的是一段被截斷的開頭而不是完整的 dump，所以請把 tag 縮小或把逾時調長，不要相信已經送到的那個尾巴。 |
版本與廠商注意事項
- 在新一點的版本上 shell 使用者讀不到 `/data/anr`，這正是「不用 root 怎麼讀 ANR 追蹤」的答案：同一份追蹤就在 drop box 裡，而 dumpsys 願意交出來。
- 不要不給 tag 就跑 `--print`。在開機一個月的手機上，輸出可能有好幾十 MB。
- tag 是慣例而不是列舉出來的，廠商會加自己的。沒見過的 tag 一樣讀得到，只是無法分類。
這個我們有 UI
Android ADB Toolbox 會透過 USB 執行這個指令並解析回應——只要 Chromium 系瀏覽器，不必安裝 SDK，也不會上傳任何東西。
相關指令
和 dumpsys dropbox 會在同一次作業裡出現的指令。
| 指令 | 做什麼 |
|---|---|
| logcat | 串流系統紀錄：手機上發生的一切的實況轉播。 |
| dumpsys activity activities | 現在哪個 app 在前景，以及它背後的 task 與 stack 結構。 |
| run-as | 以某個 app 自己的 uid 執行指令——這是不用 root 讀取可除錯版本私有檔案的方法。 |
其他系統服務（dumpsys）指令
| 指令 | 做什麼 |
|---|---|
| dumpsys battery | 電池服務目前的狀態：電量、充電狀態、健康度、電壓與溫度。 |
| dumpsys diskstats | 每個分割區的剩餘空間、一次磁碟寫入延遲的實測，以及一份快取起來的各 app 空間用量。 |
| dumpsys thermalservice | 手機是不是正在因為溫度而降速，以及硬體層回報的每一個溫區，單位是攝氏。 |
| dumpsys sensorservice | 手機上的每一個感測器，含廠商、type、取樣率與批次能力，以及一段近期讀數的緩衝。 |
| dumpsys meminfo | 哪些行程最吃記憶體，量的是 PSS（按比例分攤的用量）。 |
| dumpsys package | 套件管理員知道的一切：版本、路徑、flags、安裝來源，以及每個使用者的狀態。 |
這些行為是在撰寫 Web ADB 工具背後的解析程式時，對照 AOSP、toybox 與核心原始碼查證的。真的會因 Android 版本或廠牌而異的地方，這一頁會直接說明，而不是給你一個在半數手機上都是錯的數字。