ASP.NET 新手註冊功能報錯排查：從連接字串到參數化命令

ASP.NET 初學者在實現用戶註冊時，常因連接字串配置錯誤、SQL 語法問題或未使用參數化命令而遭遇異常。本文以一個典型的註冊按鈕點擊事件為例，梳理排查思路並給出安全重構方案。

原始代碼隱患

提問者的代碼直接拼接用戶輸入構建 SQL，且未展示具體錯誤信息，但隱患顯而易見：

• 連接字串 `yhzlConnectionString` 在 `web.config` 中可能未正確配置。
• SQL 字串拼接易導致語法錯誤（如欄位名含逗號、保留字）且極易遭受 SQL 注入。
• 未使用 `using` 語句確保連接關閉，異常時可能洩漏資源。

protected void Button4_Click(object sender, EventArgs e) {
    string usersex = " ";
    if (RadioButton3.Checked == true) usersex = "男";
    else usersex = "女";
    
    string connString = System.Configuration.ConfigurationManager.ConnectionStrings["yhzlConnectionString"].ConnectionString;
    SqlConnection myConn = new SqlConnection(connString);
    // 危險：直接拼接用戶輸入
    string sqlStr = " insert into 用戶資料(用戶名,密碼，權限，性別，地址) values('" + txtzcName.Text.ToString() + "','" + txtzcPasswork.Text.ToString() + "','" + 0 + "','" + usersex + "','" + txtadd.Text.ToString() + "') ";
    SqlCommand myCmd = new SqlCommand(sqlStr, myConn);
    myConn.Open();
    myCmd.ExecuteNonQuery();
    myConn.Close();
}

排查步驟

1. 查看具體異常： 捕獲 `SqlException` 並記錄 `Message` 與 `StackTrace`，或直接在 Visual Studio 中啟用「中斷於所有異常」。
2. 驗證連接字串： 打開 `web.config`，確認 `` 節點下 `name="yhzlConnectionString"` 存在且 `connectionString` 屬性正確指向數據庫實例。
3. 檢查 SQL 語法： 在 SSMS 中直接執行生成的 SQL 字串，排除欄位名拼寫、標點符號（如中文逗號）錯誤。

安全重構版本（推薦）

使用參數化命令與 `using` 區塊，同時解決安全、語法與資源管理問題：

protected void Button4_Click(object sender, EventArgs e) {
    string usersex = RadioButton3.Checked ? "男" : "女";
    string connString = ConfigurationManager.ConnectionStrings["yhzlConnectionString"].ConnectionString;
    
    // 參數化 SQL，欄位名建議加方括號避免保留字衝突
    string sqlStr = @"INSERT INTO [用戶資料] ([用戶名], [密碼], [權限], [性別], [地址]) 
                      VALUES (@UserName, @Password, @Role, @Sex, @Address)";

    using (SqlConnection conn = new SqlConnection(connString))
    using (SqlCommand cmd = new SqlCommand(sqlStr, conn)) {
        cmd.Parameters.AddWithValue("@UserName", txtzcName.Text.Trim());
        cmd.Parameters.AddWithValue("@Password", txtzcPasswork.Text.Trim()); // 實際應存儲哈希值
        cmd.Parameters.AddWithValue("@Role", 0);
        cmd.Parameters.AddWithValue("@Sex", usersex);
        cmd.Parameters.AddWithValue("@Address", txtadd.Text.Trim());
        
        conn.Open();
        cmd.ExecuteNonQuery();
    } // 自動關閉連接
}

採用此模式，您的註冊功能將更健壯、更安全。