c# 如何连接mysql数据库

来源：这里教程网时间：2026-02-21 17:36:15 作者：

用 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+ 默认认证方式与旧驱动不兼容导致的。

临时解决：在 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<t></t>
异步推荐写法：

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 生命周期和凭据管理这四点，最容易在上线后出问题。