MySqlConnector 是推荐的 MySQL .NET 连接器,支持 .NET 6+ 和异步操作,无 Oracle 依赖,默认 utf8mb4,需处理认证插件兼容性、DataReader 生命周期及连接字符串安全存储。

用 MySqlConnector 连接 MySQL(推荐)
官方 MySQL Connector/NET 已停止维护,MySqlConnector 是当前最活跃、兼容性最好、支持 .NET 6+ 和异步操作的开源替代方案。它完全遵循 MySQL 协议,无 Oracle 依赖,且性能更优。
安装方式(NuGet):
dotnet add package MySqlConnector
连接示例(同步):
using MySqlConnector;
string connectionString = "Server=localhost;Port=3306;Database=testdb;User ID=root;Password=123456;";
using var conn = new MySqlConnection(connectionString);
conn.Open();
Console.WriteLine("Connected: " + conn.State);
-
connectionString中必须包含Server、Database、User ID和Password;端口Port可省略(默认 3306) - 若使用 Unix socket 或 SSL,需显式添加
Socket=/var/run/mysqld/mysqld.sock或SslMode=Required - 连接字符串中不要加
charset=utf8mb4——MySqlConnector默认启用utf8mb4,加了反而可能触发重复编码警告
处理 ConnectionFailedException 或 AuthenticationPluginNotSupportedException
常见错误信息如:Authentication plugin 'caching_sha2_password' cannot be loaded,这是 MySQL 8.0+ 默认认证方式与旧驱动不兼容导致的。
Difeye是一款超轻量级PHP框架,主要特点有: Difeye是一款超轻量级PHP框架,主要特点有: ◆数据库连接做自动主从读写分离配置,适合单机和分布式站点部署; ◆支持Smarty模板机制,可灵活配置第三方缓存组件; ◆完全分离页面和动作,仿C#页面加载自动执行Page_Load入口函数; ◆支持mysql,mongodb等第三方数据库模块,支持读写分离,分布式部署; ◆增加后台管理开发示例
- 临时解决:在 MySQL 中为用户切换认证插件:
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '123456'; FLUSH PRIVILEGES;
- 长期建议:保持
MySqlConnector≥ 2.2.0 版本,它原生支持caching_sha2_password和sha256_password,无需降级认证方式 - 若仍报错,请确认连接字符串中没误写
Allow User Variables=True等已废弃参数
执行查询并读取数据(避免 DataReader 提前释放)
MySqlDataReader 是只进、只读、连接绑定的流式读取器,一旦 MySqlConnection 关闭或 MySqlCommand 被回收,它立刻不可用。
- 务必在
using块内完成读取,不要返回未消费完的MySqlDataReader - 需要缓存结果?用
DataTable.Load(reader)或手动构建List - 异步推荐写法:
using var cmd = new MySqlCommand("SELECT id, name FROM users", conn);
using var reader = await cmd.ExecuteReaderAsync();
while (await reader.ReadAsync())
{
int id = reader.GetInt32("id");
string name = reader.GetString("name");
Console.WriteLine($"{id}: {name}");
}
连接字符串敏感信息怎么安全存放?
硬编码密码在代码或 appsettings.json 明文里都不可取。开发阶段可用 User Secrets,生产环境应走环境变量或密钥管理服务。
- 本地开发:运行
dotnet user-secrets set "ConnectionStrings:MySql" "Server=...;Password=...",再用Configuration.GetConnectionString("MySql")读取 - Docker/K8s 场景:通过
-e CONNECTIONSTRINGS_MYSQL="..."注入环境变量,代码中用Environment.GetEnvironmentVariable("CONNECTIONSTRINGS_MYSQL") - 切勿把密码提交到 Git —— 即使是私有仓库,也要当成已泄露来设计
MySQL 连接本身不难,但认证方式、字符集隐式行为、DataReader 生命周期和凭据管理这四点,最容易在上线后出问题。









