C#怎么连接MySQL数据库_C#如何安装配置MySqlData【基础】-C#.Net教程-PHP中文网

推荐使用 MySqlConnector 替代 MySql.Data，因其原生支持 async/await、无全局锁、兼容 .NET 6+；连接字符串兼容无需修改；须用 await using 管理连接生命周期；参数绑定必须用 @ 符号并避免 AddWithValue；需用户变量时添加 Allow User Variables=true。

c#怎么连接mysql数据库_c#如何安装配置mysqldata【基础】

安装 MySqlConnector 而不是 MySql.Data

官方 MySql.Data 包在 .NET 6+ 上存在隐式线程同步、连接池不稳定、异步方法实际是同步伪装等问题，尤其在高并发 Web 场景下容易卡死或抛 MySqlException: Timeout expired。推荐直接用开源替代品 MySqlConnector，它原生支持 async/await、无全局锁、兼容 .NET Core / .NET 5+。

实操建议：

通过 NuGet 安装：dotnet add package MySqlConnector
代码中 using 语句写 using MySqlConnector;，不是 MySql.Data.MySqlClient
连接字符串格式完全兼容，无需修改（如 "Server=localhost;Database=test;Uid=root;Pwd=123;"）

正确写法：用 MySqlConnection + await using 管理生命周期

常见错误是手动调用 Open() 后忘记 Close()，或在异常路径下连接泄漏；更隐蔽的问题是复用同一个 MySqlConnection 实例跨线程或跨 await —— 这会触发 InvalidOperationException: Connection is already in use。

实操建议：

永远用 await using var conn = new MySqlConnection(connStr);，让 Dispose 自动释放连接
每个查询/命令都新建连接，别缓存 MySqlConnection 对象
执行命令时必须用 await cmd.ExecuteReaderAsync() 或 await cmd.ExecuteNonQueryAsync()，别混用同步方法

await using var conn = new MySqlConnection(connStr);
await conn.OpenAsync();
using var cmd = conn.CreateCommand();
cmd.CommandText = "SELECT id, name FROM users WHERE id = @id";
cmd.Parameters.Add(new MySqlParameter("@id", userId));
await using var reader = await cmd.ExecuteReaderAsync();

参数绑定必须用 @ 符号，别拼 SQL

手拼字符串如 "SELECT * FROM users WHERE name = '" + name + "'" 会直接导致 SQL 注入，且 MySQL 对单引号、反斜杠等字符处理严格，容易报 MySqlException: You have an error in your SQL syntax。

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

实操建议：

所有用户输入必须走 cmd.Parameters.Add(new MySqlParameter("@name", name))
MySQL 参数名以 @ 开头（不是 : 或 $），且命名需与 SQL 中一致
不要用 AddWithValue —— 它可能推断错类型（比如把空字符串当 TEXT 而非 VARCHAR），引发隐式转换失败

连接字符串里别漏 Allow User Variables=true

如果后续要执行带用户变量的 SQL（如 SET @row := 0; SELECT @row := @row + 1 AS row_num, name FROM users），默认连接会拒绝执行，抛 MySqlException: User variable '@row' is not allowed。

实操建议：