.NET 中的异步 Dispose 模式如何正确实现？

来源：这里教程网时间：2026-02-21 17:28:12 作者：

.NET 中的异步 Dispose 模式用于释放需要异步操作才能完成清理的资源，比如关闭网络连接、写入日志文件或释放数据库事务。由于传统的 IDisposable 接口中的 Dispose 方法是同步的，无法直接等待异步操作，因此在需要异步清理时，必须采用新的模式来正确实现。

理解 IAsyncDisposable 接口

.NET Core 3.0 引入了 IAsyncDisposable 接口，提供了一个异步的 DisposeAsync 方法：

public interface IAsyncDisposable
{
ValueTask DisposeAsync();
}

实现该接口的对象可以通过 await using 语法进行异步资源管理。

正确实现异步 Dispose 的步骤

要正确实现异步 Dispose，需遵循以下关键原则：

同时实现 IDisposable 和 IAsyncDisposable（如有必要）：如果类型可能被同步或异步上下文使用，应同时实现两个接口，确保兼容性。 避免在 Dispose 中调用异步方法并阻塞：不要在同步的 Dispose 方法中调用 async 方法并使用 .Result 或 .Wait()，这可能导致死锁。 共享清理逻辑：将实际的资源释放逻辑放在一个受保护的方法中，由 Dispose 和 DisposeAsync 共同调用，避免重复代码。 正确处理 ValueTask：DisposeAsync 返回 ValueTask，应避免多次调用或重用已完成的 ValueTask。

示例：正确实现 IAsyncDisposable

以下是一个典型实现：

public class AsyncResource : IAsyncDisposable, IDisposable
{
    private bool _disposed = false;

    protected virtual ValueTask DisposeAsyncCore()
    {
        // 实际异步清理操作
        return default;
    }

    protected virtual void DisposeCore()
    {
        // 同步清理操作
    }

    public async ValueTask DisposeAsync()
    {
        if (_disposed) return;

        await DisposeAsyncCore().ConfigureAwait(false);

        DisposeCore(); // 同步清理

        _disposed = true;
    }

    public void Dispose()
    {
        if (_disposed) return;

        DisposeCore();

        DisposeAsyncCore().GetAwaiter().GetResult(); // 避免使用 .Result

        _disposed = true;
    }
}

注意：在 Dispose 中调用异步方法只能通过 GetAwaiter().GetResult() 安全地阻塞，避免死锁风险。但更推荐的做法是，若仅支持异步清理，只实现 IAsyncDisposable。