在帳號新增/同步流程中,BroadcastReceiver.onReceive() 常被用於處理認證回調、資料庫寫入、網路請求。但 onReceive 運行於主執行緒,**必須在 10 秒內完成**,否則觸發 ANR。本文針對常見崩潰與效能問題提供解決方案。
| 問題 | 徵兆 | 根因 |
|---|---|---|
| ANR (Application Not Responding) | 系統彈出「應用程式無回應」對話框 | onReceive 執行耗時操作 (網路、DB、檔案 I/O) 超過 10 秒 |
| NullPointerException (頭像為空) | 崩潰堆疊指向 ImageView.setImageBitmap(null) | 未對伺服器回傳 null 头像做預設圖處理 |
| ListView 滑動卡頓 | 滑動時幀率下降、GC 頻繁 | getView 每次 new View/inflate、未使用 ViewHolder、圖片未快取 |
| OAuth 回調頁面 404 | 授權成功後跳轉到找不到頁面 | callback URL scheme 未在 Manifest 正確宣告、或攜帶參數格式錯誤 |
| 帶圖片發布失敗 | 分享圖片無反應或報錯 | 缺少 activation.jar、Uri 權限未授予、檔案路徑非 content:// |
| 分頁載入重複建立 Adapter | 翻頁時閃爍、資料錯位、偶發 Crash | 每次拿到新資料就 new Adapter(),應改用 notifyDataSetChanged() 或 DiffUtil |
// 方案 A: goAsync() (最多延長 10 秒,適合輕量 DB/IO)
override fun onReceive(context: Context, intent: Intent) {
val pending = goAsync()
CoroutineScope(Dispatchers.IO).launch {
try {
db.insertAccount(account)
context.sendBroadcast(Intent(ACTION_SYNC_DONE))
} finally {
pending.finish()
}
}
}
// 方案 B: 啟動 Service / WorkManager (推薦,無時間限制)
override fun onReceive(context: Context, intent: Intent) {
val work = OneTimeWorkRequestBuilder()
.setInputData(workDataOf("account_id" to accountId))
.build()
WorkManager.getInstance(context).enqueue(work)
}
val avatarUrl = user.avatarUrl ?: "@drawable/ic_default_avatar"
Glide.with(context).load(avatarUrl).circleCrop().into(avatarView)
ViewHolder 模式 (RecyclerView 強制)。DiffUtil 或 ListAdapter 自動計算最小更新。onBindViewHolder 執行複雜邏輯。<data android:scheme="你的scheme" android:host="callback" />。onNewIntent 確保單一 Task 內接收回調。val uri = FileProvider.getUriForFile(context, "${packageName}.provider", imageFile)
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
intent.putExtra(Intent.EXTRA_STREAM, uri)
呼叫網路 API 時,使用 **具名參數** 或 **Builder 模式**,避免順序錯誤:
// 錯誤:易搞混順序
api.post(userId, token, content, imageUri)
// 正確:Builder / Data Class
api.post(PostRequest(userId = userId, token = token, content = content, imageUri = imageUri))
遵循上述原則,可消除帳號頁面 90% 以上的 ANR、崩潰與體驗問題。