做瑞芯微RK平臺(tái)Android開(kāi)發(fā)/技術(shù)支持的同學(xué)，想必都遇見(jiàn)過(guò)內(nèi)核panic、應(yīng)用Crash、ANR這類頭疼的問(wèn)題，排查的核心難點(diǎn)往往是日志難獲取、有效信息少、user版本無(wú)日志。而瑞芯微自研的RK Android LOG系統(tǒng)，完美解決了這些痛點(diǎn)——它基于異常觸發(fā)記錄日志，user版本可用，還能自動(dòng)保存內(nèi)核和Android層的各類異常信息，是RK平臺(tái)問(wèn)題排查的核心工具。

今天這篇文章，我們就把這套LOG系統(tǒng)的使用方法、排查思路、配置技巧講透，從日志存儲(chǔ)、獲取到問(wèn)題定位，一步到位幫你搞定RK平臺(tái)的Android問(wèn)題排查！

一、先搞懂：RK LOG系統(tǒng)的核心優(yōu)勢(shì)

和傳統(tǒng)Android日志系統(tǒng)相比，RK LOG系統(tǒng)專為線上/線下問(wèn)題排查設(shè)計(jì)，核心亮點(diǎn)直擊開(kāi)發(fā)者痛點(diǎn)，也是我們優(yōu)先選擇它的原因：

1.User版本可用：無(wú)需切換到userdebug/eng版本，線上設(shè)備也能捕獲異常日志，解決線上問(wèn)題排查無(wú)日志的核心難題；

2.異常觸發(fā)式記錄：避免無(wú)意義日志刷屏，僅當(dāng)系統(tǒng)出現(xiàn)異常時(shí)才生成日志，有效信息密度高；

3.全鏈路異常捕獲：既支持內(nèi)核層panic/卡死，也能捕獲Android層Crash/ANR/低內(nèi)存/Watchdog等幾乎所有異常；

4.重啟后日志不丟失：內(nèi)核panic重啟、Android系統(tǒng)重啟后，會(huì)自動(dòng)保存重啟前的異常信息，不會(huì)因重啟丟失關(guān)鍵日志；

5.存儲(chǔ)與訪問(wèn)便捷：日志有固定存儲(chǔ)路徑，還提供軟鏈接快速訪問(wèn)，支持ADB和U盤/SD卡兩種獲取方式；

6.智能控容+防抖：限制日志總大小，自動(dòng)刪除最早日志；相同異常5分鐘內(nèi)僅記錄一次，避免日志爆倉(cāng)。

二、基礎(chǔ)必備：日志的存儲(chǔ)路徑與獲取方式

排查問(wèn)題的第一步，是找到日志在哪、怎么把日志拿到本地。RK LOG系統(tǒng)的日志存儲(chǔ)做了專門的優(yōu)化，路徑清晰、獲取方式簡(jiǎn)單，新手也能快速上手。

2.1日志存儲(chǔ)路徑（核心）

所有異常日志最終都保存在主路徑：

/data/user_de/0/com.android.shell/files/bugreports

為了方便開(kāi)發(fā)者訪問(wèn)，系統(tǒng)在根目錄創(chuàng)建了軟鏈接，直接訪問(wèn)以下路徑即可，無(wú)需輸入長(zhǎng)路徑：

/bugreports/

（驗(yàn)證軟鏈接：在設(shè)備端執(zhí)行l(wèi)s bugreports -l，可看到鏈接指向主路徑）

2.2兩種日志獲取方式

方式1：ADB命令獲?。ㄍ扑]開(kāi)發(fā)/調(diào)試時(shí)使用）

設(shè)備連接電腦并開(kāi)啟ADB調(diào)試后，直接執(zhí)行拉取命令，將日志文件夾拉到本地指定路徑即可：

# 拉取全部日志到本地桌面（示例，可修改本地路徑）adbpull /bugreports/ ~/Desktop/RK_LOG/# 僅拉取指定異常日志（如內(nèi)核panic日志）adbpull /bugreports/2022-09-24-09-58-10-kernel_panic.zip ~/Desktop/

方式2：U盤/SD卡拷貝（適合無(wú)電腦連接的線下設(shè)備）

無(wú)需ADB，直接通過(guò)設(shè)備自帶的文件管理器拷貝，前提是先開(kāi)啟設(shè)備的【開(kāi)發(fā)者選項(xiàng)】，具體步驟如下：

1.進(jìn)入設(shè)備「設(shè)置」，點(diǎn)擊「Storage（存儲(chǔ)）」；

2.點(diǎn)擊「Go to Files app to manage and free up space」進(jìn)入Files文件管理器；

3.點(diǎn)擊左上角列表圖標(biāo)/從左向右滑動(dòng)調(diào)出列表菜單，找到「Bug reports」選項(xiàng)；

4.進(jìn)入后可看到所有日志壓縮包，直接選擇需要的日志，拷貝到U盤/SD卡即可（也可直接刪除無(wú)用日志）。

2.3關(guān)鍵：日志文件的命名規(guī)則

RK LOG系統(tǒng)的日志均為日期開(kāi)頭的zip壓縮包，文件名直接包含時(shí)間+異常類型，能讓我們快速定位「最新日志」和「問(wèn)題類型」，核心命名規(guī)則如下：

1.時(shí)間前綴：YYYY-MM-DD-HH-MM-SS，精確到秒，按時(shí)間排序即可找到最新異常；

2.固定標(biāo)識(shí)：

3.SYSTEM_BOOT：設(shè)備開(kāi)機(jī)時(shí)生成的日志，此文件之后的日志均為本次開(kāi)機(jī)后產(chǎn)生的，是排查開(kāi)機(jī)后問(wèn)題的時(shí)間錨點(diǎn)；

4.SYSTEM_RESTART：Android系統(tǒng)重啟時(shí)生成的日志，看到此文件說(shuō)明設(shè)備發(fā)生過(guò)系統(tǒng)重啟；

5.異常類型標(biāo)識(shí)：如kernel_panic/TOMBSTONE/system_app_crash等，直接對(duì)應(yīng)具體異常（后續(xù)會(huì)詳細(xì)講解）。

示例：

2023-03-14-10-04-27-SYSTEM_BOOT.zip→ 2023-03-14 1027的開(kāi)機(jī)日志

2022-09-24-09-58-10-kernel_panic.zip→ 2022-09-24 0910的內(nèi)核panic異常日志

2023-03-14-10-04-39-system_app_crash.zip→ 2023-03-14 1039的系統(tǒng)應(yīng)用崩潰日志

三、核心排查思路：按日志類型定位問(wèn)題根源

RK LOG系統(tǒng)將異常分為內(nèi)核層和Android層兩大類，不同類型的異常對(duì)應(yīng)不同的日志文件，我們只需根據(jù)文件名的異常標(biāo)識(shí)，就能快速定位問(wèn)題根源，無(wú)需在海量日志中篩選。

3.1內(nèi)核層問(wèn)題排查：關(guān)注kernel_panic.zip

內(nèi)核層問(wèn)題主要為內(nèi)核panic和內(nèi)核卡死，是底層硬件/內(nèi)核驅(qū)動(dòng)的核心問(wèn)題，排查重點(diǎn)如下：

1.內(nèi)核panic重啟：系統(tǒng)會(huì)生成kernel_panic.zip，壓縮包內(nèi)包含panic的具體內(nèi)核日志，直接解析即可定位panic原因（如段錯(cuò)誤segment fault）；

2.內(nèi)核卡死（無(wú)重啟）：默認(rèn)情況下，僅segment fault會(huì)觸發(fā)kernel panic，而hard lock/soft lock/rcu stall等情況會(huì)導(dǎo)致內(nèi)核卡死但不重啟，此時(shí)無(wú)默認(rèn)日志，需按以下方式處理：

3.若能接串口：在串口使用fiq工具抓取更多內(nèi)核日志；

4.若無(wú)法接串口：開(kāi)啟內(nèi)核配置，讓卡死觸發(fā)panic并生成日志，需開(kāi)啟的配置如下：

CONFIG_BOOTPARAM_HUNG_TASK_PANIC=yCONFIG_BOOTPARAM_SOFTLOCKUP_PANIC=yCONFIG_BOOTPARAM_HARDLOCKUP_PANIC=yCONFIG_BOOTPARAM_RCU_STALL_PANIC=y

5.版本注意事項(xiàng)：瑞芯微SDK/補(bǔ)丁僅在user版本默認(rèn)開(kāi)啟上述配置，若在userdebug版本使用，需手動(dòng)在arch/arm64/configs/rockchip_defconfig文件中添加上述配置。

3.2 Android層問(wèn)題排查：按標(biāo)識(shí)匹配異常類型

Android層異常覆蓋系統(tǒng)服務(wù)、系統(tǒng)App、用戶App、框架層，共10余種核心異常，每種異常都有專屬的日志標(biāo)識(shí)，TOMBSTONE默認(rèn)強(qiáng)制觸發(fā)日志（除非配置為0），其他異?？赏ㄟ^(guò)配置篩選。

以下是Android層核心異常標(biāo)識(shí)與問(wèn)題對(duì)應(yīng)表，建議收藏備用：

排查技巧：先看日志的SYSTEM_BOOT時(shí)間，確定本次開(kāi)機(jī)范圍，再?gòu)淖钚氯罩镜臉?biāo)識(shí)判斷問(wèn)題類型——比如看到data_app_anr，直接定位到用戶第三方App的ANR問(wèn)題，無(wú)需排查系統(tǒng)層。

四、靈活配置：根據(jù)需求調(diào)整日志抓取規(guī)則

RK LOG系統(tǒng)提供了異常抓取級(jí)別和日志最大容量兩大核心配置，開(kāi)發(fā)者可根據(jù)排查需求（如僅抓內(nèi)核問(wèn)題、限制日志大?。╈`活修改，適配不同的使用場(chǎng)景。

4.1配置1：異常抓取級(jí)別（persist.sys.rklog.level）

通過(guò)系統(tǒng)屬性persist.sys.rklog.level可配置需要捕獲的Android層異常范圍，內(nèi)核panic日志不受此配置影響（除非配置為0），核心規(guī)則：

?默認(rèn)值：7，覆蓋大部分核心異常，滿足日常排查需求；

?配置為0：不抓取任何Android層異常，僅捕獲內(nèi)核panic日志，適合僅排查內(nèi)核問(wèn)題的場(chǎng)景；

?數(shù)值含義：數(shù)值為N時(shí)，會(huì)捕獲枚舉中1~N的所有異常，TOMBSTONE默認(rèn)觸發(fā)（除非配置0）。

異常枚舉定義（關(guān)鍵）：

enum{DROPBOX_SYSTEM_SERVER_CRASH =1, // 系統(tǒng)服務(wù)CrashDROPBOX_SYSTEM_SERVER_ANR =2,  // 系統(tǒng)服務(wù)ANRDROPBOX_SYSTEM_SERVER_LOWMEM =3,// 系統(tǒng)服務(wù)低內(nèi)存DROPBOX_SYSTEM_SERVER_WATCHDOG =4,// 系統(tǒng)服務(wù)WatchdogDROPBOX_SYSTEM_RESTART =5,   // 系統(tǒng)重啟DROPBOX_SYSTEM_APP_CRASH =6,  // 系統(tǒng)App CrashDROPBOX_SYSTEM_APP_ANR =7,   // 系統(tǒng)App ANRDROPBOX_SYSTEM_SERVER_WTF =8,  // 系統(tǒng)服務(wù)WTFDROPBOX_SYSTEM_APP_WTF =9,   // 系統(tǒng)App WTFDROPBOX_DATA_APP_ANR =10,    // 用戶App ANRDROPBOX_DATA_APP_CRASH =11,   // 用戶App CrashDROPBOX_DATA_APP_WTF =12,    // 用戶App WTF};

配置方法（ADB臨時(shí)配置，重啟后失效；若需永久配置，需修改系統(tǒng)屬性默認(rèn)文件）：

# 配置為12，捕獲所有Android層異常（適合全面排查）adbshell setprop persist.sys.rklog.level12# 配置為0，僅抓內(nèi)核panicadbshell setprop persist.sys.rklog.level0

4.2配置2：日志最大容量（dumpstate.max_log_size）

RK LOG系統(tǒng)默認(rèn)限制日志總大小為300M，避免日志占滿設(shè)備存儲(chǔ)，可通過(guò)該屬性調(diào)整容量，核心規(guī)則：

1.單位：MB，配置值為N則日志總大小限制為N M；

2.觸發(fā)機(jī)制：日志總大小超過(guò)限制時(shí)，自動(dòng)刪除最早生成的日志，保證新日志能正常生成；

3.核心說(shuō)明（回應(yīng)核心疑問(wèn)）：①原文確實(shí)未提及getprop dumpstate.max_log_size相關(guān)配置，補(bǔ)充該命令是因?yàn)椋涸膬H講配置方法，未提供「驗(yàn)證配置是否生效」的實(shí)操手段，而getprop是Android系統(tǒng)通用的屬性查詢命令，能快速確認(rèn)配置是否落地，完善配置全流程（修改→生效→驗(yàn)證），適配開(kāi)發(fā)者實(shí)際調(diào)試場(chǎng)景；②該配置雖在dumpstate.cpp中通過(guò)代碼實(shí)現(xiàn)，但支持動(dòng)態(tài)修改（臨時(shí)生效），核心邏輯的結(jié)合你找到的代碼分析如下：

代碼核心行：long long int max_log_size = (long long int)android::GetIntProperty("dumpstate.max_log_size", 300);
邏輯拆解：函數(shù)GetIntProperty的優(yōu)先級(jí)是「動(dòng)態(tài)系統(tǒng)屬性>代碼默認(rèn)值」——先讀取系統(tǒng)中dumpstate.max_log_size的動(dòng)態(tài)屬性值（若用setprop設(shè)置過(guò)），若未設(shè)置，則使用代碼中定義的默認(rèn)值300；因此，動(dòng)態(tài)修改（setprop）是臨時(shí)生效（重啟后動(dòng)態(tài)屬性消失，恢復(fù)代碼默認(rèn)值），永久修改需修改代碼默認(rèn)值并編譯生效。

1.臨時(shí)配置（ADB動(dòng)態(tài)修改，重啟失效）

適合調(diào)試階段快速調(diào)整，無(wú)需編譯源碼，直接通過(guò)setprop動(dòng)態(tài)修改，驗(yàn)證效果：

# 設(shè)置日志最大容量為200M（數(shù)值可自定義）adbshell setprop dumpstate.max_log_size200# 立即查詢動(dòng)態(tài)修改后的數(shù)值（驗(yàn)證動(dòng)態(tài)修改是否生效）adbshell getprop dumpstate.max_log_size

注意：動(dòng)態(tài)修改僅在本次開(kāi)機(jī)有效，重啟設(shè)備后，動(dòng)態(tài)屬性消失，恢復(fù)為dumpstate.cpp中定義的代碼默認(rèn)值。

2.永久配置（適配RK3576 Android 15，源碼層修改）

適合正式版本固化配置，需修改代碼默認(rèn)值并編譯，步驟如下：

步驟1：打開(kāi)源碼文件

vim~/teamstore/xiesc/RK72/rk3576_android15/frameworks/native/cmds/dumpstate/dumpstate.cpp

步驟2：修改代碼默認(rèn)值

找到你通過(guò)grep定位到的核心代碼行（默認(rèn)值為300）：

// 修改前l(fā)onglongintmax_log_size = (longlongint)android::GetIntProperty("dumpstate.max_log_size",300);// 修改后（以200M為例，可自定義數(shù)值）longlongintmax_log_size = (longlongint)android::GetIntProperty("dumpstate.max_log_size",200);

保存并退出（Esc→:wq）。

步驟3：編譯dumpstate模塊

在源碼根目錄執(zhí)行編譯命令（Android 15推薦用mm替代舊版mmm）：

# 進(jìn)入源碼根目錄cd~/teamstore/xiesc/RK72/rk3576_android15/# 單獨(dú)編譯dumpstate模塊（僅編譯修改的文件，速度快）mm frameworks/native/cmds/dumpstate/

步驟4：讓配置生效（兩種方式任選）

?調(diào)試場(chǎng)景（無(wú)需全量刷鏡像）：

?正式發(fā)布場(chǎng)景（全量編譯鏡像）：

3.配置生效驗(yàn)證（核心：getprop命令的作用）

無(wú)論臨時(shí)動(dòng)態(tài)修改，還是永久源碼修改，均需通過(guò)getprop命令驗(yàn)證，確保配置落地：

adb root# Android 15需先關(guān)閉分區(qū)驗(yàn)證才能重掛載adb shell disable-verityadb rebootadb rootadb remount# 推送編譯后的文件到設(shè)備adb push out/target/product/<你的板型名稱>/system/bin/dumpstate /system/bin/# 修改權(quán)限并重啟服務(wù)adb shellchmod755 /system/bin/dumpstateadb shell stop dumpstate && adb shell start dumpstate

4.3特殊機(jī)制：5分鐘異常防抖

為避免相同異常短時(shí)間反復(fù)觸發(fā)導(dǎo)致日志爆倉(cāng)（如同一處system_server_wtf反復(fù)報(bào)錯(cuò)），RK LOG系統(tǒng)做了防抖處理：

本次開(kāi)機(jī)內(nèi)，相同原因的異常5分鐘內(nèi)僅生成一次日志。

注意：并非系統(tǒng)未捕獲異常，而是防抖機(jī)制限制，5分鐘后若異常再次觸發(fā)，會(huì)生成新的日志。

五、排查實(shí)戰(zhàn)小技巧（效率翻倍）

1.快速找最新日志：設(shè)備端執(zhí)行l(wèi)s -l /bugreports/，日志會(huì)按時(shí)間倒序排列，最后一行即為最新異常日志；

2.按異常類型篩選：使用ls /bugreports/ | grep 異常標(biāo)識(shí)快速篩選，如ls /bugreports/ | grep crash篩選所有Crash日志；

3.線上設(shè)備排查：優(yōu)先用「U盤/SD卡拷貝」方式獲取日志，無(wú)需開(kāi)啟ADB，避免線上設(shè)備調(diào)試風(fēng)險(xiǎn)；

4.內(nèi)核問(wèn)題優(yōu)先串口：若能接設(shè)備串口，內(nèi)核卡死時(shí)優(yōu)先用fiq工具抓取日志，比開(kāi)啟配置更高效；

5.日志及時(shí)備份：異常日志為zip壓縮包，拉取到本地后建議按「設(shè)備號(hào)+時(shí)間+異常類型」重命名，方便后續(xù)歸檔和分析；

6.多設(shè)備批量排查：通過(guò)ADB批量命令拉取多臺(tái)設(shè)備的/bugreports/日志，統(tǒng)一分析異常規(guī)律；

7.Android 15權(quán)限適配：修改/system/bin/下文件時(shí)，需先執(zhí)行adb shell disable-verity關(guān)閉分區(qū)驗(yàn)證，否則remount會(huì)失敗。

六、總結(jié)

RK Android LOG系統(tǒng)是瑞芯微為RK平臺(tái)量身打造的問(wèn)題排查核心工具，其「user版本可用、異常觸發(fā)、全鏈路捕獲」的特性，完美解決了Android開(kāi)發(fā)中日志難獲取、有效信息少的痛點(diǎn)。

針對(duì)RK3576 Android 15版本，結(jié)合代碼實(shí)現(xiàn)和實(shí)際調(diào)試場(chǎng)景，掌握這套工具的核心要點(diǎn)：

1.記路徑：日志核心路徑/bugreports/（軟鏈接），無(wú)需記憶長(zhǎng)路徑；

2.識(shí)命名：通過(guò)日志文件名的「時(shí)間+異常標(biāo)識(shí)」快速定位問(wèn)題類型；

3.調(diào)配置：異常抓取級(jí)別改persist.sys.rklog.level；日志最大容量支持「臨時(shí)動(dòng)態(tài)修改（setprop，重啟失效）」和「永久源碼修改（改dumpstate.cpp默認(rèn)值，編譯生效）」，兩者優(yōu)先級(jí)：動(dòng)態(tài)屬性>代碼默認(rèn)值；

希望這篇適配RK3576 Android 15的指南能幫你搞定RK平臺(tái)的日志排查，讓問(wèn)題定位更高效！

審核編輯 黃宇