萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> 資料庫綜合

.NET 應用連接 MySQL 完整指南:從 Connector/NET 到 EF Core 實戰

前言:MySQL 與 .NET 生態的融合之路

MySQL 憑藉開源免費、高效能、易部署,成為 .NET 應用 (特別是 .NET Core / 5+ 跨平台場景) 的熱門資料庫選擇。本文系統梳理:原生 ADO.NET (MySqlConnector)、ORM (EF Core/Dapper)、連線池、安全強化、效能調優、遷移策略,助你構建穩健的資料存取層。

一、 驅動選擇:MySqlConnector vs Oracle 官方驅動

維度MySqlConnector (社群推薦)MySql.Data (Oracle 官方)
效能✅ 更快、記憶體佔用更低、完全異步實現較舊、同步/異步混用
相容性.NET Standard 2.0+、.NET Core/5+/Framework 4.6.1+.NET Framework 4.5+、.NET Core 3.1+
功能完整度支援所有主流協議、負載均衡、管線化官方支援、某些企業功能優先
維護活躍度GitHub 星標 3k+、持續釋出更新較慢
NuGet 套件MySqlConnectorMySql.Data

建議: 新專案**首選 MySqlConnector**,舊專案遷移成本極低 (命名空間相同 MySql.Data.MySqlClient),僅需替換 NuGet 套件。

二、 ADO.NET 核心操作模式

2.1 連線字串最佳實踐

// appsettings.json
"ConnectionStrings": {
  "MySql": "Server=127.0.0.1;Port=3306;Database=mydb;Uid=app_user;Pwd=*****;Charset=utf8mb4;SslMode=Required;Connection Lifetime=300;Pooling=true;MinPoolSize=5;MaxPoolSize=100;"
}

關鍵參數: Charset=utf8mb4 (對應 character_set_client)、SslMode=Required (生產環境強制加密)、Pooling=true (啟用連線池)、Connection Lifetime (秒,避免長連線殭屍)。

2.2 基礎 CRUD 範本 (MySqlConnector 異步優先)

public class UserRepository
{
    private readonly string _connStr;
    public UserRepository(IConfiguration cfg) => _connStr = cfg.GetConnectionString("MySql");

    public async Task GetByIdAsync(int id)
    {
        const string sql = "SELECT id, username, email, created_at FROM users WHERE id = @id";
        await using var conn = new MySqlConnection(_connStr);
        await conn.OpenAsync();
        await using var cmd = new MySqlCommand(sql, conn);
        cmd.Parameters.AddWithValue("@id", id);
        await using var reader = await cmd.ExecuteReaderAsync();
        if (await reader.ReadAsync())
            return new User { Id = reader.GetInt32(0), Username = reader.GetString(1), Email = reader.GetString(2), CreatedAt = reader.GetDateTime(3) };
        return null;
    }

    public async Task InsertAsync(User user)
    {
        const string sql = @"INSERT INTO users (username, email, created_at) VALUES (@u, @e, @c); SELECT LAST_INSERT_ID();";
        await using var conn = new MySqlConnection(_connStr);
        await conn.OpenAsync();
        await using var cmd = new MySqlCommand(sql, conn);
        cmd.Parameters.AddWithValue("@u", user.Username);
        cmd.Parameters.AddWithValue("@e", user.Email);
        cmd.Parameters.AddWithValue("@c", user.CreatedAt);
        return Convert.ToInt32(await cmd.ExecuteScalarAsync());
    }
}

2.3 參數化查詢:防注入鐵律

**永遠使用參數化**,絕不拼接字串。cmd.Parameters.AddWithValue 方便但隱含型別推斷風險,關鍵查詢建議顯式指定 MySqlDbType:

cmd.Parameters.Add(new MySqlParameter("@id", MySqlDbType.Int32) { Value = id });

三、 現代 ORM 整合:Entity Framework Core

3.1 套件安裝

dotnet add package MySql.EntityFrameworkCore  // Oracle 官方 Provider
// 或
dotnet add package Pomelo.EntityFrameworkCore.MySql  // 社群版,效能更強、功能更全

3.2 DbContext 配置

public class AppDbContext : DbContext
{
    public DbSet Users => Set();
    protected override void OnConfiguring(DbContextOptionsBuilder opt)
        => opt.UseMySql(Configuration.GetConnectionString("MySql"), 
            ServerVersion.AutoDetect(Configuration.GetConnectionString("MySql"))); // 自動偵測版本
}

3.3 遷移與種子資料

dotnet ef migrations add InitialCreate
dotnet ef database update

// 種子資料
protected override void OnModelCreating(ModelBuilder b) {
    b.Entity().HasData(new User { Id = 1, Username = "admin", Email = "admin@example.com", CreatedAt = DateTime.UtcNow });
}

四、 輕量級 ORM:Dapper + MySqlConnector

追求極致效能、手寫 SQL 掌控力時,Dapper 是最佳拍檔:

public async Task> GetActiveUsersAsync()
{
    const string sql = "SELECT id, username, email FROM users WHERE is_active = 1";
    await using var conn = new MySqlConnection(_connStr);
    return await conn.QueryAsync(sql); // 自動映射
}

// 多重映射 (One-to-Many)
var lookup = new Dictionary();
await conn.QueryAsync(
    @"SELECT u.id, u.username, o.id, o.amount FROM users u LEFT JOIN orders o ON u.id = o.user_id",
    (u, o) => {
        if (!lookup.TryGetValue(u.Id, out var user)) lookup[u.Id] = user = u;
        if (o.Id > 0) user.Orders.Add(o);
        return user;
    },
    splitOn: "id");
return lookup.Values;

五、 連線池與效能調優

  • 預熱: 應用啟動時建立幾條連線,避免首請求延遲。
  • 監控: SHOW STATUS LIKE 'Threads_connected';、PerformanceSchema、APM 工具 (Datadog, Elastic APM)。
  • 避免連線洩漏: **務必 `using` / `await using` 自動 Dispose**,釋放回池。
  • 批次操作: 大量寫入用 MySqlBulkLoader (LOAD DATA INFILE) 或 EF Core BulkInsert 擴充套件。
  • 命令超時: 設定 cmd.CommandTimeout = 30 (秒),防止長查詢佔用連線。

六、 安全強化清單

  1. 最小權限帳號: 應用布號僅擁有特定庫的 SELECT, INSERT, UPDATE, DELETE, EXECUTE,禁止 DROP, ALTER, GRANT。
  2. SSL/TLS 加密傳輸: MySQL 伺服器配置 require_secure_transport=ON,客戶端 SslMode=VerifyFull (驗證 CA)。
  3. 防 SQL 注入: 全域參數化、存儲過程、ORM 參數化、WAF 二次防護。
  4. 審計日誌: 啟用 MySQL audit_log 插件,記錄所有 DDL/DML 操作。
  5. 連線字串加密: Azure Key Vault / AWS Secrets Manager / HashiCorp Vault 管理密碼,啟動時注入環境變數。

七、 Mono / Legacy .NET Framework 遷移提示

  • 舊專案使用 ByteFX.Data.MySqlClient (Mono 早期),命名空間不同,遷移時需批次替換 using 陳述式。
  • .NET Framework 4.8 專案可直接引用 MySqlConnector,無程式碼變更即可獲得效能提升。
  • 遷移至 .NET 6+ 時,將 App.config 連線字串移至 appsettings.json,使用 IConfiguration 統一管理。

八、 總結

.NET 連接 MySQL 的最佳路徑已清晰:**驅動用 MySqlConnector,ORM 首選 EF Core (Pomelo Provider) 或 Dapper,配置 utf8mb4 + SSL + 連線池,落實參數化與最小權限**。這套組合在高併發、跨平台、雲原生環境下均經過大規模生產驗證,能為業務系統提供穩如磐石的資料存取基石。

copyright © 萬盛學電腦網 all rights reserved