萬盛學電腦網

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

C# 連接 MySQL 完整實戰:MySqlConnector 驅動、連接池、參數化查詢、異步模式與 EF Core 整合

從 ADO.NET 到 EF Core,構建高性能、安全、可維護的 .NET 數據訪問層

.NET 生態連接 MySQL 歷經 MySql.Data (Oracle 官方) → MySqlConnector (社區高性能分支) 兩代。本文基於 **MySqlConnector 2.x** (推薦,.NET Standard 2.0+, 完全異步、連接池優化、修復大量 Bug),提供從基礎 CRUD 到企業級架構的完整指南。

環境準備

<PackageReference Include="MySqlConnector" Version="2.3.5" />

dotnet add package MySqlConnector

連接字符串最佳實踐

"Server=10.0.1.10;Port=3306;Database=PhoneBook;Uid=app_user;Pwd=Str0ngP@ss!;" +
"SslMode=Required;CertificateStoreLocation=CurrentUser;CertificateThumbprint=...;" +  -- 生產必開 SSL
"ConnectionReset=true;Pooling=true;MinPoolSize=5;MaxPoolSize=100;" +
"ConnectionLifeTime=300;DefaultCommandTimeout=30;CharacterSet=utf8mb4;" +
"AllowUserVariables=true;UseAffectedRows=true;"

基礎 ADO.NET 異步模式 (推薦生產全異步)

public class PhoneRepository
{
    private readonly string _connStr;
    public PhoneRepository(string connStr) => _connStr = connStr;

    private MySqlConnection CreateConnection() => new MySqlConnection(_connStr);

    public async Task AddAsync(string name, string phone, CancellationToken ct = default)
    {
        const string sql = @"INSERT INTO PhoneBook (Name, Phone) VALUES (@Name, @Phone);
                             SELECT LAST_INSERT_ID();";
        await using var conn = CreateConnection();
        await conn.OpenAsync(ct);
        await using var cmd = new MySqlCommand(sql, conn);
        cmd.Parameters.AddWithValue("@Name", name);
        cmd.Parameters.AddWithValue("@Phone", phone);
        return Convert.ToInt32(await cmd.ExecuteScalarAsync(ct));
    }

    public async Task> GetAllAsync(CancellationToken ct = default)
    {
        const string sql = "SELECT Id, Name, Phone FROM PhoneBook ORDER BY Id";
        await using var conn = CreateConnection();
        await conn.OpenAsync(ct);
        await using var cmd = new MySqlCommand(sql, conn);
        await using var reader = await cmd.ExecuteReaderAsync(ct);
        var list = new List();
        while (await reader.ReadAsync(ct))
        {
            list.Add(new Contact {
                Id = reader.GetInt32(0),
                Name = reader.GetString(1),
                Phone = reader.GetString(2)
            });
        }
        return list;
    }
}

public record Contact(int Id, string Name, string Phone);

連接池原理與調優

  • **進程級池化**:同連接字符串 (含 User/Password) 共享池,MinPoolSize 預熱、MaxPoolSize 上限 (默認 100)。
  • **連接生命週期**:ConnectionLifeTime (秒) 控制連接回收重建,防止長連接攜帶舊狀態 (如會話變量、準備語句緩存)。
  • **避免池耗盡**:
    — 必須 `using` / `await using` 確保 `Dispose()` 歸還連接。
    — 異步代碼全鏈路 `async/await`,避免 `.Result`/.`Wait()` 死鎖佔用線程池。
    — 監視計數器:`MySqlConnection.GetPoolCounters()` 或 Prometheus `mysql_connector_pool_*` 指標。

Dapper 輕量 ORM 整合 (高性能、無跟蹤)

using Dapper;

public async Task GetByIdAsync(int id)
{
    const string sql = "SELECT Id, Name, Phone FROM PhoneBook WHERE Id = @Id";
    await using var conn = CreateConnection();
    return await conn.QuerySingleOrDefaultAsync(sql, new { Id = id });
}

public async Task BulkInsertAsync(IEnumerable contacts)
{
    const string sql = "INSERT INTO PhoneBook (Name, Phone) VALUES (@Name, @Phone)";
    await using var conn = CreateConnection();
    return await conn.ExecuteAsync(sql, contacts); // 批量參數化,單次往返
}

EF Core 8 + Pomelo.EntityFrameworkCore.MySql (企業級首選)

<PackageReference Include="Pomelo.EntityFrameworkCore.MySql" Version="8.0.0" />

public class AppDbContext : DbContext
{
    public DbSet PhoneBook => Set();
    
    protected override void OnConfiguring(DbContextOptionsBuilder options)
        => options.UseMySql(_connStr, ServerVersion.AutoDetect(_connStr), b => 
            b.CharSetBehavior(CharSetBehavior.NeverAppend) // 避免隱式字符集轉換
        );

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity(e => {
            e.ToTable("PhoneBook");
            e.Property(p => p.Name).HasMaxLength(100).IsRequired();
            e.Property(p => p.Phone).HasMaxLength(20).IsRequired();
            e.HasIndex(p => p.Phone).IsUnique();
        });
    }
}

// 使用
await using var ctx = new AppDbContext();
var list = await ctx.PhoneBook.Where(p => p.Name.Contains("張")).ToListAsync();
await ctx.PhoneBook.AddAsync(new Contact(0, "李四", "13800001111"));
await ctx.SaveChangesAsync();

關鍵最佳實踐清單

  1. 參數化查詢:絕不拼接 SQL,防注入、利用查詢計劃緩存。
  2. 異步全鏈路:Controller → Service → Repository 全 `async/await`,釋放線程池支撐高併發。
  3. 連接字符串外部化:`appsettings.json` + `IOptions` / Azure Key Vault / AWS Secrets Manager,絕不硬編碼。
  4. 彈性重試:`EnableRetryOnFailure(maxRetryCount: 3, maxRetryDelay: TimeSpan.FromSeconds(5), errorNumbersToAdd: null)` 處理瞬態故障。
  5. 讀寫分離:EF Core 8 `UseQueryTrackingBehavior(QueryTrackingBehavior.NoTracking)` + 只讀從庫連接字符串。
  6. 遷移管理:`dotnet ef migrations add Init` → `dotnet ef database update`,生產環境**禁止**自動遷移,由 CI/CD 部署腳本執行。
  7. 性能分析:`MiniProfiler` / `EFCore.BulkExtensions` 批量操作 / `ToQueryString()` 檢查生成 SQL。

避坑指南

  • MySql.Data (Oracle) 存在已知 Bug:連接池洩漏、異步不完整、SSL 驗證問題 → **堅決遷移至 MySqlConnector**。
  • `CHARSET=utf8` 只支持 BMP 字符,**必須用 `utf8mb4`** 存儲 Emoji/生僻字。
  • `DateTime` 幾值無法存儲 `0000-00-00`,設置 `AllowZeroDateTime=true` 或改用 `DATE` 類型。
  • 大文本/Blob:`CommandTimeout` 調大、考慮 `Compress=true` (需服務端支持)、分塊讀寫。

選對驅動、用好異步、管好連接池、擁抱 EF Core — .NET 連接 MySQL 可達生產級穩定與高性能。

copyright © 萬盛學電腦網 all rights reserved