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