Android BroadcastReceiver 中彈出 AlertDialog 崩潰：兼容包選擇與 Context 類型深度解析

問題現象

開發者在廣播接收器中嘗試顯示 AlertDialog，導致程序崩潰。發現將導入包從 android.support.v7.app.AlertDialog 改為 android.app.AlertDialog 後問題解決，疑惑兼容包反而失效的原因。

核心原因：Context 類型不匹配

關鍵點：BroadcastReceiver.onReceive() 接收的 Context 是 ReceiverRestrictedContext（受限上下文），非 Activity Context。

兩種 AlertDialog 的構造差異

為什麼兼容包更嚴格？

AppCompat 版 AlertDialog 內部需要訪問主題屬性（如 alertDialogTheme、colorAccent 等），這要求 Context 能正確解析主題資源。ReceiverRestrictedContext 為安全考慮，禁用了主題解析相關功能，導致兼容包構建失敗。

正確解決方案（按推薦度排序）

方案一：使用系統原生 AlertDialog（最簡單）

public class MyReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        // 直接使用 android.app.AlertDialog
        new android.app.AlertDialog.Builder(context)
            .setTitle("提示")
            .setMessage("收到廣播")
            .setPositiveButton("確定", null)
            .show(); // 安全，不依賴主題解析
    }
}

方案二：啟動 Activity 顯示對話框（規範做法）

廣播接收器不應直接彈窗，應啟動透明 Activity 或全屏對話框 Activity：

// AndroidManifest.xml


// Receiver 中
public void onReceive(Context context, Intent intent) {
    Intent i = new Intent(context, DialogActivity.class);
    i.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); // 必須標記
    context.startActivity(i);
}

方案三：若必須用 AppCompat Dialog，包裝 Context

// 僅在確保有 Activity 可用時使用（如有序廣播中）
ContextThemeWrapper wrapper = new ContextThemeWrapper(context, R.style.AppTheme);
new androidx.appcompat.app.AlertDialog.Builder(wrapper)
    .setTitle("標題")
    .show();

Android 版本兼容性說明

• Android 7.0+：系統對話框樣式已現代化，原生 AlertDialog 體驗良好
• Android 5.0-6.0：原生對話框風格較舊，但功能完整
• 全版本：推薦方案二（Activity 承載），體驗一致且符合架構規範

廣播接收器最佳實踐總結

1. 執行時間限制：onReceive 必須在 10 秒內完成，耗時操作啟動 Service
2. 避免 UI 操作：不直接彈窗、不操作 View，通過啟動 Activity 實現
3. 靜態註冊優先：清單文件聲明，進程啟動自動生效
4. 動態註冊配對：onResume 註冊，onPause 註銷，防洩漏
5. 權限防護：敏感廣播加 android:permission 或 sendBroadcast(intent, permission)

總結

兼包 AlertDialog 失效的根因是 ReceiverRestrictedContext 無法滿足 AppCompat 主題解析需求。系統原生 AlertDialog 因不依賴複雜主題而能正常工作。但從架構規範角度，廣播接收器不應直接承載 UI 交互，正確做法是啟動承載對話框的 Activity。理解 Context 類型差異、Dialog 實現機制、組件職責邊界，是 Android 進階開發的必修課。