Android NullPointerException 排查實戰：從 Logcat 定位問題

遇到 Unfortunately, App has stopped，Logcat 顯示 java.lang.NullPointerException at MainActivity.onCreate(MainActivity.java:29)，這是最典型的空指針異常。關鍵在於第 29 行嘗試存取未初始化的物件。

快速定位三步驟

1. 鎖定行號：打開 MainActivity.java 跳至第 29 行。
2. 檢視該行程式碼：常見情況包括 findViewById 回傳 null 卻直接呼叫方法、Intent.getExtras() 為 null 卻取值、未初始化的陣列/集合操作。
3. 加入防禦性判斷：在存取前以 if (obj != null) 或 Objects.requireNonNull() 防護。

實例重現與修正

// 錯誤寫法：若 R.id.textView 不存在於佈局，findViewById 回傳 null
TextView tv = findViewById(R.id.textView);
tv.setText("Hello"); // 第 29 行拋出 NPE

// 正確寫法
TextView tv = findViewById(R.id.textView);
if (tv != null) {
    tv.setText("Hello");
} else {
    Log.e("MainActivity", "textView not found in layout");
}

進階除錯技巧

• 使用 Android Studio 斷點除錯，觀察變數狀態。
• 啟用 StrictMode 捕獲主執行緒違規。
• 釋出版本採用 Crashlytics 或 Firebase Crashlytics 自動收集堆疊追蹤。

記住：NullPointerException 總是指向「誰為 null」，順著堆疊追蹤往上找第一行專案程式碼即是突破口。