C#怎么连接MySQL数据库_C# MySqlConnector操作MySQL教程【实战】

穿越時空

穿越時空

2026-04-24

903人浏览

原创

用mysqlconnector是当前最稳妥的选择,因其开源无gpl风险、原生真异步、连接池与ssl等细节处理更严谨;而mysql.data存在伪异步、连接泄漏、认证失败及维护滞后等硬伤。

c#怎么连接mysql数据库_c# mysqlconnector操作mysql教程【实战】

直接说结论:用 MySqlConnector(不是 MySql.Data)是当前最稳妥的选择,尤其在 .NET 6+ 和异步场景下。它开源、无 GPL 传染风险、原生支持 async/await,且对连接池、SSL、时区等细节处理更严谨。

为什么别用 MySql.Data(Oracle 官方驱动)

很多老教程还在推 MySql.Data,但它存在几个硬伤:
MySql.Data 的 NuGet 包(如 8.2.x)仍基于 .NET Framework 旧架构,在 .NET 5/6/7/8 中偶发连接泄漏或 NullReferenceException
— 它的 MySqlCommand.ExecuteReaderAsync() 实际是同步封装,不是真异步,高并发下线程池易耗尽;
— 默认不启用 SSL,连本地 MySQL 8.0+ 时可能因 caching_sha2_password 插件报错:Authentication plugin 'caching_sha2_password' cannot be loaded
— 官方维护节奏慢,GitHub Issues 常年积压。

MySqlConnector 的正确安装与基础连接

在 Visual Studio 中右键项目 → “管理 NuGet 包” → 搜索并安装:MySqlConnector(注意:不是 MySql.Data,也不是带 “Official” 字样的包)。
引入命名空间:using MySqlConnector;
连接字符串示例(关键参数已加注):

string connStr = "Server=127.0.0.1;Port=3306;Database=testdb;Uid=root;Pwd=123456;" +
                 "Allow User Variables=True;" +        // 必开:否则 @var 赋值失败
                 "SslMode=None;" +                     // 本地开发可关;生产环境建议 Prefer 或 Required
                 "Connection Timeout=10;" +            // 避免卡死
                 "Default Command Timeout=30;";

验证连接是否可用(不建议长期持有一个静态 MySqlConnection):

using var conn = new MySqlConnection(connStr);
await conn.OpenAsync(); // 真异步,不阻塞线程
Console.WriteLine(conn.State == ConnectionState.Open ? "OK" : "Failed");

执行 SQL 时最容易踩的三个坑

拼接字符串写 SQL:示例里那种 "INSERT ... VALUES('" + DateTime.Now + "') 是典型反模式,会触发 SQL 注入、时区错乱、格式崩溃(比如 DateTime 默认含空格和冒号,MySQL 不认);
忘记 using 或 DisposeMySqlConnectionMySqlCommandMySqlDataReader 都实现 IDisposable,漏掉会导致连接池耗尽,现象是后续连接卡在 OpenAsync() 不返回;
参数名写错或类型不匹配:MySQL 参数前缀是 @,不是 :$MySqlParameter 构造时若传 DBNull.Value,必须显式指定 DbType,否则可能报 Unable to cast object of type 'System.DBNull' to type 'System.IConvertible'

MySQL(Linux)
MySQL(Linux)

MySQL 9.6.0是面向Linux平台的2026年创新版本,核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层,确保所有数据变更均被完整记录至Binlog,彻底解决了CDC(变更数据捕获)与主从复制中的数据不一致难题。此外,该版本引入container_aware启动选项以原生适配容器环境,并对审计日志进行了组件化重构,为追求极致数据一致性与云原生体验的开发者提供了全新选择。

下载

正确写法(带参数化 + 异步):

string sql = "INSERT INTO users (username, email, created_at) VALUES (@name, @email, @time)";
using var cmd = new MySqlCommand(sql, conn);
cmd.Parameters.AddWithValue("@name", "alice");
cmd.Parameters.AddWithValue("@email", "alice@example.com");
cmd.Parameters.AddWithValue("@time", DateTime.UtcNow); // 用 UtcNow,避免本地时区干扰
int rows = await cmd.ExecuteNonQueryAsync();

连接池没生效?检查这几个配置项

MySqlConnector 默认启用连接池(Pooling=true),但以下情况会让池失效:
— 连接字符串中任意字符不同(比如多一个空格、端口写成 "3306 ")→ 视为全新连接串,新建池;
— 显式设置 Pooling=false
— 使用 MySqlConnection.ClearAllPools() 后未重建;
— 连接打开后未正常关闭(异常中断、未 await Dispose)→ 连接留在池中但状态异常,后续获取时抛 MySqlException: Connection must be Open

调试建议:
— 开启日志(仅开发期):AppContext.SetSwitch("MySqlConnector.EnableLogging", true);,看控制台输出是否频繁新建物理连接;
— 查 MySQL 服务端当前连接数:SHOW STATUS LIKE 'Threads_connected';,持续上涨说明池没起作用。

真正麻烦的从来不是“连上”,而是连接生命周期管理、参数绑定语义、时区与字符集传递这些隐性细节。尤其在 WinForms 或 ASP.NET Core 后台服务中混用同步/异步调用时,MySqlConnector 的行为比 MySql.Data 可预测得多——但前提是连接字符串每项都写对,且每个 using 都闭合干净。

相关专题

更多
C语言变量命名
C语言变量命名

c语言变量名规则是:1、变量名以英文字母开头;2、变量名中的字母是区分大小写的;3、变量名不能是关键字;4、变量名中不能包含空格、标点符号和类型说明符。php中文网还提供c语言变量的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

1351

3

c语言入门自学零基础
c语言入门自学零基础

C语言是当代人学习及生活中的必备基础知识,应用十分广泛,本专题为大家c语言入门自学零基础的相关文章,以及相关课程,感兴趣的朋友千万不要错过了。

2023.07.25

1558

9

c语言运算符的优先级顺序
c语言运算符的优先级顺序

c语言运算符的优先级顺序是括号运算符 > 一元运算符 > 算术运算符 > 移位运算符 > 关系运算符 > 位运算符 > 逻辑运算符 > 赋值运算符 > 逗号运算符。本专题为大家提供c语言运算符相关的各种文章、以及下载和课程。

2023.08.02

692

5

c语言数据结构
c语言数据结构

数据结构是指将数据按照一定的方式组织和存储的方法。它是计算机科学中的重要概念,用来描述和解决实际问题中的数据组织和处理问题。数据结构可以分为线性结构和非线性结构。线性结构包括数组、链表、堆栈和队列等,而非线性结构包括树和图等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.09

551

4

c语言random函数用法
c语言random函数用法

c语言random函数用法:1、random.random,随机生成(0,1)之间的浮点数;2、random.randint,随机生成在范围之内的整数,两个参数分别表示上限和下限;3、random.randrange,在指定范围内,按指定基数递增的集合中获得一个随机数;4、random.choice,从序列中随机抽选一个数;5、random.shuffle,随机排序。

2023.09.05

910

5

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

1128

7

c语言get函数的用法
c语言get函数的用法

get函数是一个用于从输入流中获取字符的函数。可以从键盘、文件或其他输入设备中读取字符,并将其存储在指定的变量中。本文介绍了get函数的用法以及一些相关的注意事项。希望这篇文章能够帮助你更好地理解和使用get函数 。

2023.09.20

1683

8

c数组初始化的方法
c数组初始化的方法

c语言数组初始化的方法有直接赋值法、不完全初始化法、省略数组长度法和二维数组初始化法。详细介绍:1、直接赋值法,这种方法可以直接将数组的值进行初始化;2、不完全初始化法,。这种方法可以在一定程度上节省内存空间;3、省略数组长度法,这种方法可以让编译器自动计算数组的长度;4、二维数组初始化法等等。

2023.09.22

5610

6

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

2023.09.22

420

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 124人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 224人学习

phpEnv手册
phpEnv手册

共0课时 | 0人学习