萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

SubSonic 3.0 更新長字串拋出 TDS 協議錯誤修正 (Size = -1)

錯誤現象

System.Data.SqlClient.SqlException (0x80131904): 
傳入的表格格式資料流 (TDS) 遠程程序呼叫 (RPC) 協議流不正確。
參數 4 ("@up_Content"): 資料類型 0xA7 (NVarChar) 的資料長度或中繼資料長度無效。

發生於 SubSonic 3.0 更新 `NVARCHAR(MAX)` / `VARCHAR(MAX)` 欄位時,長度超過 4000/8000 字元。

根本原因

SubSonic 3.0 `AddParams` 方法預設將字串參數 `Size` 設為字串長度,若超過 4000 (NVarChar) 或 8000 (VarChar),SQL Server TDS 協議要求 `Size = -1` 代表 `MAX`,否則視為協議錯誤。

修正代碼 (修改 SubSonic 核心或專案覆寫)

// 位置: SubSonic.Schema/QueryCommand.cs 或專案自訂繼承類別
private static void AddParams(DbCommand cmd, QueryCommand qry)
{
    if (qry.Parameters == null) return;

    foreach (QueryParameter param in qry.Parameters)
    {
        DbParameter p = cmd.CreateParameter();
        p.ParameterName = param.ParameterName;
        p.Direction = param.Mode;
        p.DbType = param.DataType;

        // === 關鍵修正:AnsiString / String 且為輸入參數時,Size = -1 表示 MAX ===
        if ((param.DataType == DbType.AnsiString || param.DataType == DbType.String) 
            && (p.Direction == ParameterDirection.Input || p.Direction == ParameterDirection.InputOutput))
        {
            p.Size = -1; // NVARCHAR(MAX) / VARCHAR(MAX)
        }
        // 輸出參數保留原邏輯 (需指定具體 Size)
        else if (p.Direction == ParameterDirection.Output || p.Direction == ParameterDirection.InputOutput)
        {
            p.Size = param.Size > 0 ? param.Size : 4000;
        }

        // NULL 值處理
        if (param.ParameterValue == null)
            p.Value = DBNull.Value;
        else if (param.DataType == DbType.Guid)
        {
            string val = param.ParameterValue.ToString();
            p.Value = string.IsNullOrEmpty(val) || val.Equals("DEFAULT", StringComparison.OrdinalIgnoreCase)
                ? DBNull.Value : (object)new Guid(val);
        }
        else
            p.Value = param.ParameterValue;

        cmd.Parameters.Add(p);
    }
}

驗證方式

  1. 建立測試資料表:`CREATE TABLE Test (Id INT IDENTITY, Content NVARCHAR(MAX))`
  2. SubSonic 更新超過 5000 字元的字串。
  3. 確認無 `SqlException` 且資料完整寫入。

遷移建議

SubSonic 3.0 為 2010 年左右專案,已停止維護。新專案或重構時建議遷移至:

  • Dapper:輕量、高效能、手寫 SQL 完全掌控參數 `Size`。
  • Entity Framework Core:`HasMaxLength(-1)` / `IsUnicode()` Fluent API 自動對應 `MAX`。
  • SqlSugar / FreeSql:國產 ORM 功能豐富、支援多資料庫。

相關知識點

  • ADO.NET `SqlParameter.Size = -1` 代表 `MAX` (SQL Server 2005+)。
  • TDS 協議 7.3+ 版本強制要求 `MAX` 型別參數 `Size = -1` 或 `0`。
  • SubSonic 3.0 源碼可在 GitHub `subsonic/SubSonic-3.0` 找到,建議 Fork 維護專屬版本。
copyright © 萬盛學電腦網 all rights reserved