如何在C# MySQL应用中处理数据库查询避免UI冻结？

1. 重构数据访问层为异步模式 #

原同步方法会阻塞UI线程，且直接返回MySqlDataReader存在资源泄漏风险，改为异步实现并返回实体对象：

首先定义用户实体类（按需扩展字段）：

public class User
{
    public string Clave { get; set; } = string.Empty;
}

修改MdlUsers类的异步查询方法：

public class MdlUsers
{
    public static async Task<User?> GetUserByUsernameAsync(string username)
    {
        try
        {
            using var conn = MdlConnection.Connect();
            await conn.OpenAsync();
            // 仅查询所需字段，避免不必要的数据传输
            string qry = "SELECT clave FROM usuarios WHERE login = @username";
            using var cmd = new MySqlCommand(qry, conn);
            cmd.Parameters.AddWithValue("@username", username);

            using var reader = await cmd.ExecuteReaderAsync();
            if (await reader.ReadAsync())
            {
                return new User
                {
                    Clave = reader["clave"].ToString() ?? string.Empty
                };
            }
            return null;
        }
        catch (Exception ex)
        {
            // 数据层仅抛异常，UI层统一处理提示
            throw new Exception("查询用户信息失败", ex);
        }
    }
}

2. 异步处理登录按钮点击事件 #

将按钮点击事件改为异步方法，使用await执行数据库操作，避免UI线程阻塞，且await后自动回到UI上下文，无需额外处理跨线程访问：

private async void btnLogin_Click(object sender, EventArgs e)
{
    // 禁用按钮防止重复提交
    btnLogin.Enabled = false;
    try
    {
        var user = await MdlUsers.GetUserByUsernameAsync(txtUser.Text);
        if (user != null)
        {
            if (user.Clave.Equals(txtPassword.Text))
            {
                MessageBox.Show("Acceso correcto.");
                logged = true;
            }
            else
            {
                MessageBox.Show("Acceso denegado.");
                logged = false;
            }
        }
        else
        {
            MessageBox.Show("No regresó nada.");
            logged = false;
        }
    }
    catch (Exception ex)
    {
        MessageBox.Show($"登录出错：{ex.Message}");
        logged = false;
    }
    finally
    {
        // 恢复按钮状态
        btnLogin.Enabled = true;
    }
}

关键注意事项 #

• 资源安全：所有实现IDisposable的数据库对象（连接、命令、DataReader）用using语句自动释放，避免连接池耗尽。
• 上下文自动切换：await会捕获当前UI线程上下文，后续代码可直接访问UI控件，无需手动调用Invoke/BeginInvoke。
• 解耦设计：数据层仅负责数据操作，UI提示逻辑放在UI层，提升代码可维护性。
• 避免SELECT*：仅查询所需字段，减少数据传输量，提升查询效率。

内容的提问来源于stack exchange，提问作者Hikaros