Android Intent 跳轉崩潰：Context 類型錯誤排查與修正

崩潰現象

調用 startActivity(intent) 時應用崩潰，日誌提示：android.util.AndroidRuntimeException: Calling startActivity() from outside of an Activity context requires the FLAG_ACTIVITY_NEW_TASK flag。

原因分析

代碼中創建 Intent 時傳入的 this 並非 Activity 類型的 Context。常見場景：

• 在非 Activity 類（如工具類、Service、BroadcastReceiver、Application）中調用 new Intent(this, TargetActivity.class)
• 在內部類、匿名類中誤用 this 指向外部類實例而非 Activity

解決方案

方案一：傳入 Activity 實例（推薦）

// 工具類方法簽名
public static void navigateToMain(Activity activity) {
    Intent intent = new Intent(activity, MainActivity.class);
    activity.startActivity(intent);
}

// 調用處
MyUtils.navigateToMain(MainActivity.this); // 或 this（在 Activity 內部）

方案二：使用 Application Context + NEW_TASK 標誌

Context appContext = context.getApplicationContext();
Intent intent = new Intent(appContext, TargetActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); // 必須添加
appContext.startActivity(intent);

注意：此方式啟動的 Activity 會創建新任務棧，返回鍵行為異於常規跳轉，僅適用於通知欄跳轉、Service 啟動界面等特殊場景。

方案三：在非 UI 線程中通過 Handler 切回主線程

new Handler(Looper.getMainLooper()).post(() -> {
    Intent intent = new Intent(activity, TargetActivity.class);
    activity.startActivity(intent);
});

最佳實踐建議

1. 封裝導航工具類，統一接收 Activity 或 Fragment（使用 fragment.requireActivity()）。
2. 避免在 Application/Service 中直接啟動 UI，改用 EventBus、LiveData、RxJava 等事件總線通知 UI 層跳轉。
3. 使用 Android Studio 的 Lint 檢查，可自動提示「Context 類型不匹配」警告。

代碼對比