【实战】高性能 Dapper 帮助类封装（MySQL 版 含异步、事务、批量、流式查询）

🚀【实战】高性能 Dapper 帮助类封装（MySQL 版 含异步、事务、批量、流式查询）

在实际开发中，Dapper 是一款高性能微型 ORM，适用于对性能要求极高的 .NET 应用。但由于其轻量特性，开发者往往需要手动封装常见操作，如事务、批量插入等。

本文将从实战出发，手把手带你构建一个面向 MySQL 的 Dapper 通用帮助类，涵盖异步操作、事务控制、批量插入、流式查询与多结果集支持，并附可视化架构图助你全面掌握。

---

✨ 功能亮点

• ✅ 全异步支持（适配高并发）
• ✅ 安全事务封装（自动回滚）
• ✅ 高性能批量插入（事务包裹）
• ✅ 多结果集读取（QueryMultiple）
• ✅ 大数据流式查询（节省内存）
• ✅ XML 注释完备，便于维护与扩展

---

🧱 开发准备

dotnet add package Dapper
dotnet add package MySql.Data

---

🔧 代码实现

using System;
using System.Collections.Generic;
using System.Data;
using System.Linq;
using System.Reflection;
using System.Threading.Tasks;
using Dapper;
using MySql.Data.MySqlClient;

public static class DapperHelper
{
   
   
    private static string _connectionString = string.Empty;

    /// <summary>
    /// 初始化数据库连接字符串。
    /// </summary>
    /// <param name="connectionString">MySQL 的连接字符串。</param>
    public static void Initialize(string connectionString)
    {
   
   
        _connectionString = connectionString;
    }

    /// <summary>
    /// 获取并打开一个 MySQL 异步连接。
    /// </summary>
    private static async Task<IDbConnection> GetOpenConnectionAsync()
    {
   
   
        var conn = new MySqlConnection(_connectionString);
        await conn.OpenAsync();
        return conn;
    }

    /// <summary>
    /// 执行 SQL 查询并返回结果集。
    /// </summary>
    /// <typeparam name="T">返回的数据类型。</typeparam>
    /// <param name="sql">SQL 查询语句。</param>
    /// <param name="parameters">参数对象，默认为 null。</param>
    /// <param name="timeout">命令超时时间（秒）。</param>
    public static async Task<IEnumerable<T>> QueryAsync<T>(string sql, object? parameters = null, int? timeout = null)
    {
   
   
        using var connection = await GetOpenConnectionAsync();
        return await connection.QueryAsync<T>(sql, parameters, commandTimeout: timeout);
    }

    /// <summary>
    /// 执行 SQL 查询并返回第一条结果或默认值。
    /// </summary>
    /// <typeparam name="T">返回的数据类型。</typeparam>
    /// <param name="sql">SQL 查询语句。</param>
    /// <param name="parameters">参数对象，默认为 null。</param>
    /// <param name="timeout">命令超时时间（秒）。</param>
    public static async Task<T?> QueryFirstOrDefaultAsync<T>(string sql, object? parameters = null, int? timeout = null)
    {
   
   
        using var connection = await GetOpenConnectionAsync();
        return await conn