ASP.NET 執行時期「未將物件參考設定為物件的執行個體」錯誤排查清單與解決方案

針對 ASP.NET 專案常見的 NullReferenceException，彙整九大類成因、快速定位技巧與實戰案例，幫助開發者快速止血並建立預防機制。

一、網路流傳的十大常見成因

1. ViewState 為 null：跨頁 PostBack、ViewState 加密金鑰不一致。
2. DataSet/DataTable 為 null：查詢無資料未檢查直接存取 Tables[0]。
3. SqlDataReader 為 null/未讀取：SQL 執行失敗、連線中斷、未呼叫 Read()。
4. 字串變數未初始化：string s; s += "a"; (需 string s = ""; 或 string s = null; 後判斷)。
5. 物件未 new 實例化：MyClass obj; obj.Method();。
6. Session 過期/為 null：Session["user"].ToString() 未檢查。
7. 控制項賦值時值不存在：lbl.Text = dr["col"].ToString(); 欄位為 DBNull。
8. Request.QueryString 取不到值：未傳參數、大小寫不符、未檢查 null。
9. FindControl 回傳 null：控制項 ID 錯誤、在命名容器內 (GridView/Repeater) 未用 FindControl 遞迴。
10. 重複定義/遮蔽變數：頁面層級欄位與區域變數同名導致預期外的 null。

二、快速定位三步驟

1. 啟用 VS 例外中斷：Debug → Windows → Exception Settings → 勾選 System.NullReferenceException "Thrown"。
2. 檢視堆疊追蹤：精確定位到行號與變數。
3. 加入監視/即時運算視窗：逐一驗證疑似 null 的物件鏈。

三、特殊案例深度解析

案例 1：SqlConnection.Open 拋出 NullReference (罕見)

現象：明明已 `new SqlConnection(connStr)`，呼叫 `Open()` 卻拋出 NullReference，重啟 IIS 恢復。
成因：.NET Framework 1.1 未安裝 SP1 修補程式導致內部欄位初始化競態條件。
解決：安裝 .NET Framework 1.1 SP1 或升級至 2.0+。

案例 2：IIS 處理序回收/記憶體不足導致物件意外為 null

高併發下 AppDomain 卸載、Session 遺失、靜態快取被清空。
對策：啟用健康監測、外部化 Session (StateServer/SQLServer/Redis)、實作快取失效重載邏輯。

案例 3：DAL 單例/靜態欄位在多執行緒下被覆寫

// 錯誤：頁面類別欄位共用同一 DAL 實例
private DAL dal = new DAL(); 
// 併發請求同時修改 dal 內部狀態 (如 SqlConnection) 導致互相干擾

修正：每個請求/方法內部 `using (var dal = new DAL())` 或使用 DI 容器管理生命週期 (Scoped)。

案例 4：部署環境 DLL 版本不一致

開發機編譯參考新版介面，伺服器部署舊版 DLL，介面方法簽章不符導致實例化失敗回傳 null。
檢查：`fuslogvw.exe` (組件繫結失敗記錄)、清除 Bin 目錄重新部署。

四、實戰排查清單 (Checklist)

五、最佳實務建議

• **全域錯誤處理**：`Global.asax Application_Error` 記錄完整堆疊、使用者、請求資訊，寄送警報。
• **程式碼分析**：啟用 Roslyn Analyzers (CA1062, CA1820 等) 捕捉潛在 null 解參考。
• **單元測試**：針對 null 輸入撰寫測試案例 (xUnit/NUnit)。
• **程式碼審查清單** 必含「null 檢查完整性」。