SQL命令参数：Dictionary可用但List集合不可用问题排查

1. 参数名使用C#保留关键字 #

你的函数第三个参数名params是C#的保留关键字，直接使用会导致编译器解析异常，虽然表面可能编译通过，但会引发隐性的运行时参数传递错误，这是核心问题之一。
修复：将参数名改为paramList，或者加@前缀转义（@params），避免与关键字冲突。

2. List的参数构造存在缺陷 #

对比你注释里的Dictionary写法，手动创建的SqlParameter明确设置了带@的ParameterName、DbType和Value，但外部传入List时大概率存在以下问题：

• 参数名缺少@：SQL Server存储过程的参数必须以@开头，若传入的SqlParameter的ParameterName未加@，会导致存储过程无法匹配参数，返回空结果。
• 参数类型不匹配：比如存储过程参数为VARCHAR(50)，但传入的SqlParameter的DbType设置为Int32，或未显式设置类型，导致参数值无法正确传递。
• 参数值未正确处理：参数值为null时未转为DBNull.Value，或值的格式不符合存储过程要求（如日期格式错误）。
• 重复参数：List中存在同名参数，执行cmd.Parameters.Add时添加重复参数，引发执行异常。

验证与修复步骤 #

1. 修改参数名：

public DataSet ExecuteQuery(string connName, string sp, List<SqlParameter> paramList)

2. 规范外部传入的SqlParameter：
   • 确保ParameterName以@开头（如@id）
   • DbType/SqlDbType与存储过程参数类型严格匹配
   • 空值参数设置为DBNull.Value而非null
3. 添加参数前清空集合：避免重复参数问题：

cmd.Parameters.Clear();
foreach (var param in paramList)
{
    cmd.Parameters.Add(param);
}

4. 添加异常捕获排查：捕获SQL执行异常，获取具体错误信息：

try
{
    using (SqlDataAdapter da = new SqlDataAdapter(cmd))
    {
        da.Fill(ds);
    }
}
catch (SqlException ex)
{
    // 打印或记录异常信息，定位具体错误
    Console.WriteLine(ex.Message);
    throw;
}

内容的提问来源于stack exchange，提问作者Shalini Raj