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 导致连接被中间设备干掉，应用层却以为是数据库挂了。
