C# 連接 MySQL 完整實戰：MySqlConnector 與 MySqlDriverCS 兩大方案對比

C# 連接 MySQL 完整實戰

.NET 應用連接 MySQL 主流有兩套方案：官方推薦的 MySqlConnector（原 MySql.Data）與輕量級的 MySqlDriverCS。本文提供兩者完整程式碼範例、效能特性對比、遷移建議與最佳實踐模式。

方案一：MySqlConnector (官方推薦、效能最佳、.NET Core/5/6/7/8 全支援)

NuGet 套件：MySqlConnector (推薦) 或 MySql.Data (舊版官方)

1. 基礎連線與查詢 (ADO.NET 模式)

using System;
using System.Data;
using MySqlConnector; // 或 using MySql.Data.MySqlClient;

public class MySqlDemo
{
    private readonly string _connStr = "Server=localhost;Database=testdb;Uid=root;Pwd=123456;Charset=utf8mb4;SslMode=Preferred;";

    public void QueryData()
    {
        using var conn = new MySqlConnection(_connStr);
        conn.Open();

        using var cmd = new MySqlCommand("SELECT id, name, email FROM users WHERE status = @status ORDER BY id DESC LIMIT 10", conn);
        cmd.Parameters.AddWithValue("@status", 1);

        using var reader = cmd.ExecuteReader();
        while (reader.Read())
        {
            Console.WriteLine($"ID: {reader.GetInt32(0)}, Name: {reader.GetString(1)}, Email: {reader.GetString(2)}");
        }
    }

    public int ExecuteNonQuery(string sql, params MySqlParameter[] parameters)
    {
        using var conn = new MySqlConnection(_connStr);
        using var cmd = new MySqlCommand(sql, conn);
        if (parameters != null) cmd.Parameters.AddRange(parameters);
        conn.Open();
        return cmd.ExecuteNonQuery();
    }
}

2. 連線字串關鍵參數

3. 進階模式：Dapper 輕量 ORM (強烈推薦)

// NuGet: Dapper + MySqlConnector
using Dapper;

public class UserRepository
{
    private readonly string _connStr;

    public UserRepository(string connStr) => _connStr = connStr;

    public IEnumerable GetActiveUsers(int limit = 10)
    {
        using var conn = new MySqlConnection(_connStr);
        return conn.Query("SELECT id, name, email FROM users WHERE status = 1 ORDER BY id DESC LIMIT @limit", new { limit });
    }

    public int CreateUser(User user)
    {
        using var conn = new MySqlConnection(_connStr);
        var sql = @"INSERT INTO users (name, email, status, created_at) VALUES (@Name, @Email, @Status, NOW());
                    SELECT LAST_INSERT_ID();";
        return conn.ExecuteScalar(sql, user);
    }
}

public class User { public int Id { get; set; } public string Name { get; set; } public string Email { get; set; } public int Status { get; set; } }

方案二：MySqlDriverCS (輕量、無相依、適合簡單專案/舊版 .NET Framework)

⚠️ 注意：此專案已停止維護，不建議新專案使用，僅供維護舊系統參考。

基礎用法

using System;
using System.Data;
using MySqlDriverCS;

public class LegacyMySqlDemo
{
    public void QueryWithDriverCS()
    {
        // 連線字串格式不同
        var connStr = new MySqlConnectionString("localhost", "testdb", "root", "123456").AsString;
        
        using var conn = new MySqlConnection(connStr);
        conn.Open();

        // 設定字元集 (DriverCS 需手動執行)
        using var charsetCmd = new MySqlCommand("SET NAMES utf8mb4", conn);
        charsetCmd.ExecuteNonQuery();

        using var cmd = new MySqlCommand("SELECT * FROM users", conn);
        using var adapter = new MySqlDataAdapter(cmd);
        var ds = new DataSet();
        adapter.Fill(ds, "users");

        foreach (DataRow row in ds.Tables["users"].Rows)
        {
            Console.WriteLine($"{row["id"]} - {row["name"]}");
        }
    }
}

兩大方案深度對比

遷移指南：從 MySql.Data / MySqlDriverCS 升級至 MySqlConnector

1. 移除舊套件：`Uninstall-Package MySql.Data` 或移除 MySqlDriverCS 參考
2. 安裝新套件：`Install-Package MySqlConnector`
3. 命名空間統一：`using MySqlConnector;` (類別名稱相容：MySqlConnection、MySqlCommand 等)
4. 連線字串調整：補上 Charset=utf8mb4、SslMode=Preferred
5. 測試非同步方法：將同步呼叫改為 `await cmd.ExecuteReaderAsync()` 等

生產環境最佳實踐清單

• ✅ 使用 連線池：預設開啟，勿在 using 區塊外長期持有連線
• ✅ 參數化查詢：杜絕 SQL 注入，cmd.Parameters.AddWithValue()
• ✅ 異步程式設計：Web API 必須用 `ExecuteReaderAsync`、`OpenAsync` 避免阻塞執行緒
• ✅ 連線字串外部化：存放於 `appsettings.json` / 環境變數 / Key Vault
• ✅ 啟用重試策略：Polly + MySqlConnector 處理暫時性錯誤 (Deadlock、Timeout)
• ✅ 監控慢查詢：`long_query_time=1` + `log_slow_queries=ON` + 應用層 APM
• ✅ 字元集統一 utf8mb4：資料庫、表、連線字串、C# 字串全鏈路一致

常見問題排查

現代 .NET 開發請直接選擇 MySqlConnector，配合 Dapper 或 Entity Framework Core 使用，能獲得最佳效能、功能完整度與長期維護保障。舊專案維護期滿後應規劃遷移路線圖。