C#报错：'username'附近语法不正确，多种尝试仍未解决

这种情况我之前排查过好多次，虽然你已经替换了AddWithValue为Add，但这个语法错误大概率不是参数添加方法的问题，而是SQL语句本身或者参数绑定的细节没处理对，咱们一步步来排查：

• 检查SQL语句的基础语法
  最常见的问题就是SQL语句本身写错了：

  • 有没有漏写运算符？比如把WHERE username = @username写成WHERE username @username，少了等号肯定会报语法错；
  • 是不是给参数加了多余的引号？比如写成WHERE username = '@username'，参数不需要手动加引号，SQL会自动处理类型转换，加了引号反而会把@username当成字符串字面量，导致解析错误；
  • 有没有字段名和数据库关键字冲突？虽然username一般不是关键字，但如果你的数据库有特殊配置，或者字段名是类似User这种关键字，需要用方括号包裹（比如[User]）。

• 确认参数的类型和长度匹配
  用cmd.Parameters.Add的时候，一定要指定和数据库字段匹配的SqlDbType以及长度，类型不匹配也可能被数据库解析成语法错误：
  比如你的username字段是VARCHAR(50)，那参数应该这么加：

  cmd.Parameters.Add("@username", SqlDbType.VarChar, 50).Value = yourInputUsername;
  

  如果只写cmd.Parameters.Add("@username", SqlDbType.VarChar)而不指定长度，有些数据库会默认用最大长度，可能引发隐性的解析问题。

• 打印并检查最终的CommandText
  你可以在执行命令前，把cmd.CommandText输出到控制台或者日志里，看看生成的SQL语句是不是符合预期。比如：

  Console.WriteLine(cmd.CommandText);
  

  这样能直观看到有没有拼写错误、多余字符或者未闭合的语法结构。

• 检查数据库的大小写敏感性
  部分数据库（比如PostgreSQL默认区分大小写）如果你的字段名是Username（首字母大写），但SQL里写的是全小写的username，会被当成不存在的字段，进而报语法错误。可以尝试用方括号或者双引号包裹字段名来测试：

  SELECT * FROM Users WHERE [username] = @username
  

给你一个完整的正确示例参考：

string connectionString = "你的数据库连接字符串";
string inputUsername = "testUser";
string sql = "SELECT Id, Email FROM Users WHERE username = @username";

using (SqlConnection conn = new SqlConnection(connectionString))
{
    conn.Open();
    using (SqlCommand cmd = new SqlCommand(sql, conn))
    {
        // 严格匹配字段类型和长度
        cmd.Parameters.Add("@username", SqlDbType.VarChar, 50).Value = inputUsername;
        
        using (SqlDataReader reader = cmd.ExecuteReader())
        {
            while (reader.Read())
            {
                Console.WriteLine($"Id: {reader["Id"]}, Email: {reader["Email"]}");
            }
        }
    }
}

如果按照上面的步骤排查后还是有问题，建议把你的完整SQL语句和参数添加的代码片段贴出来，这样能更精准定位问题。

内容的提问来源于stack exchange，提问作者Don Gil