C# ADO.NET 參數未指定值錯誤排查指南

錯誤現象

執行 SQL 命令時拋出「參數未指定值」異常，但開發者確認 cartid 和 cartCount 變量均有值。截圖顯示代碼被遮擋，無法直接看到 SQL 與參數綁定細節。

核心原因分析

「代碼被擋住了，看不見，肯定是你 SQL 中要求一個參數，但是你的 parameter 沒給。」—— 這是最直接的解釋。常見場景包括：

• SQL 參數名與 SqlParameter 名稱不匹配（如大小寫、前綴 @ 缺失）。
• 存在分支邏輯，某條路徑下未為參數賦值。
• 參數集合中重複添加同名參數導致覆蓋。

調試步驟

1. 檢查 SQL 文本： 確認所有 @param 占位符。
2. 對照參數集合： 逐一核對 cmd.Parameters 中的名稱、類型、值。
3. 條件斷點調試： 在疑似分支處打斷點，觀察運行時參數賦值情況。
4. 輸出命令文本： 利用 cmd.CommandText 結合參數值構建完整 SQL，直接在資料庫工具中執行驗證。

避坑建議

採用參數化查詢時，建議封裝通用的 AddParameter 輔助方法，統一處理 DBNull.Value、類型映射，減少手動拼裝錯誤。