c# 如何连接mysql数据库

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

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