mysql MySqlConnector怎么用_mysql C#驱动详解

mysqlConnector 是开源纯 .net 实现的 MySQL 驱动，替代 oracle 官方 MySql.Data；它不依赖 c++ 库、跨平台更好、异步性能更优、维护活跃，而官方驱动存在超时崩溃等问题。

MySqlConnector 是什么，和官方驱动有什么区别

MySqlConnector 是一个开源、纯 .NET 实现的 MySQL 数据库驱动，完全替代 Oracle 官方的 MySql.Data。它不依赖 native C++ 库，跨平台支持更好，异步性能更优，且持续维护活跃——而官方驱动长期存在 MySqlException: Timeout expired、NullReferenceException 在高并发下偶发崩溃等问题。

如果你用的是 .NET 5+、.NET Core 或 .NET Standard 2.0+ 项目，直接选 MySqlConnector 更稳妥；老项目若已深度耦合 MySql.Data 的特定行为（比如自定义连接字符串参数），迁移前需验证 Allow User Variables、UseAffectedRows 等开关是否等效。

安装与基础连接写法（C#）

通过 NuGet 安装：dotnet add package MySqlConnector 或在 visual studio 中搜索 MySqlConnector。

连接和查询示例：

using MySqlConnector;  string connectionString = "Server=localhost;Port=3306;database=testdb;User ID=root;Password=123456;"; using var conn = new MySqlConnection(connectionString); await conn.Openasync();  using var cmd = new MySqlCommand("SELECT COUNT(*) FROM users WHERE status = @status", conn); cmd.Parameters.Add(new MySqlParameter("@status", "active")); long count = (long)await cmd.ExecuteScalarAsync();

• MySqlConnection、MySqlCommand、MySqlParameter 都来自 MySqlConnector 命名空间，不是 MySql.Data.MySqlClient
• 务必用 await conn.OpenAsync() 而非 Open()，同步阻塞在高并发下易拖垮线程池
• 参数必须用 @name 形式，不支持 ? 占位符（除非显式设置 Allow User Variables=True）

常见报错与对应修复

以下错误基本都指向连接字符串或初始化配置问题：

• MySqlException: Authentication plugin 'caching_sha2_password' is not supported → 在连接字符串末尾加 ;sslMode=none;Allow User Variables=True，或升级 MySQL 服务端到 8.0.28+ 并设用户认证方式为 mysql_native_password
• InvalidOperationException: this MySqlConnection is already in use → 没有正确 using 或重复调用 ExecuteReaderAsync() 后未关闭 MySqlDataReader；记住：每个 MySqlCommand 实例只应执行一次查询，不可复用
• ObjectDisposedException: Cannot access a disposed object → MySqlConnection 已被 Dispose()，但后续还在访问其 State 属性或试图重用；检查是否在 using 块外引用了连接对象

连接池与超时控制的关键参数

MySqlConnector 默认启用连接池，但几个关键参数必须显式配置才能避免线上故障：

• Connection Timeout=15：建立 TCP 连接的上限时间（单位秒），默认 15，低于 5 秒容易误判网络抖动
• Command Timeout=30：SQL 执行超时（单位秒），注意这是命令级，不是连接级；若执行大表 JOIN 或 GROUP BY，需按实际耗时上调
• Maximum Pool Size=100：默认 100，但 ASP.NET Core 默认线程池上限约 50，盲目调高反而引发锁竞争；建议设为 min(100, CPU核心数 × 5)
• Keepalive=30：发送 TCP keepalive 探针间隔（秒），防止中间设备（如云负载均衡器）静默断连；不设此值，空闲连接可能被意外回收

连接字符串示例：Server=db.example.com;Port=3306;Database=app;User ID=appuser;Password=xxx;Connection Timeout=10;Command Timeout=60;Maximum Pool Size=50;Keepalive=30;

真正容易被忽略的是 Keepalive 和 Command Timeout 的协同——前者保连接不断，后者防慢查询拖垮整个池。很多“偶发连接丢失”其实只是没设 Keepalive 导致连接被中间设备干掉，应用层却以为是数据库挂了。