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

来源:这里教程网 时间:2026-02-28 20:38:36 作者:

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

相关推荐