C#使用异步操作时的注意要点(翻译)
异步操作时应注意的要点
- 使用异步方法返回值应避免使用void
- 对于预计算或者简单计算的函数建议使用Task.FromResult代替Task.Run
- 避免使用Task.Run()方法执行长时间堵塞线程的工作
- 避免使用Task.Result和Task.Wait()来堵塞线程
- 建议使用await来代替continueWith任务
- 创建TaskCompletionSource
时建议使用TaskCreationOptions.RunContinuationsAsynchronously属性 - 建议使用CancellationTokenSource(s)进行超时管理时总是释放(dispose)
- 建议将协作式取消对象(CancellationToken)传递给所有使用到的API
- 建议取消那些不会自动取消的操作(CancellationTokenRegistry,timer)
- 使用StreamWriter(s)或Stream(s)时在Dispose之前建议先调用FlushAsync
- 建议使用 async/await而不是直接返回Task
使用场景
- 使用定时器回调函数
- 创建回调函数参数时注意避免 async void
- 使用ConcurrentDictionary.GetOrAdd注意场景
- 构造函数对于异步的问题
异步操作时需要注意的要点
1.使用异步方法返回值应当避免使用void
在使用异步方法中最好不要使用void当做返回值,无返回值也应使用Task作为返回值,因为使用void作为返回值具有以下缺点
- 无法得知异步函数的状态机在什么时候执行完毕
- 如果异步函数中出现异常,则会导致进程崩溃
?异步函数不应该返回void
static void Main(string[] args)
{
try
{
// 如果Run方法无异常正常执行,那么程序无法得知其状态机什么时候执行完毕
Run();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
Console.Read();
}
static async void Run()
{
// 由于方法返回的为void,所以在调用此方法时无法捕捉异常,使得进程崩溃
throw new Exception("异常了");
await Task.Run(() => { });
}
??应该将异步函数返回Task
static async Task Main(string[] args)
{
try
{
// 因为在此进行await,所以主程序知道什么时候状态机执行完成
await RunAsync();
Console.Read();
}
catch (Exception ex)
{
Console.WriteLine(ex.Message);
}
}
static async Task RunAsync()
{
// 因为此异步方法返回的为Task,所以此异常可以被捕捉
throw new Exception("异常了");
await Task.Run(() => { });
}
注:事件是一个例外,异步事件也是返回void
2.对于预计算或者简单计算的函数建议使用Task.FromResult代替Task.Run
对于一些预先知道的结果或者只是一个简单的计算函数,使用Task,FromResult要比Task.Run性能要好,因为Task.FromResult只是创建了一个包装已计算任务的任务,而Task.Run会将一个工作项在线程池进行排队,计算,返回.并且使用Task.FromResult在具有SynchronizationContext 程序中(例如WinForm)调用Result或wait()并不会死锁(虽然并不建议这么干)
?对于预计算或普通计算的函数不应该这么写
public async Task RunAsync()
{
return await Task.Run(()=>1+1);
}
??而应该使用Task.FromResult代替
public async Task RunAsync()
{
return await Task.FromResult(1 + 1);
}
还有另外一种代替方法,那就是使用ValueTask
??使用ValueTask
static async Task Main(string[] args)
{
await AddAsync(1, 1);
}
static ValueTask AddAsync(int a, int b)
{
// 返回一个可被等待的ValueTask类型
return new ValueTask(a + b);
}
注: ValueTask
结构是C#7.0加入的,存在于Sysntem,Threading.Task.Extensions包中 ValueTask
相关文章 ValueTask
相关文章
3.避免使用Task.Run()方法执行长时间堵塞线程的工作
长时间运行的工作是指在应用程序生命周期执行后台工作的线程,如:执行processing queue items,执行sleeping,执行waiting或者处理某些数据,此类线程不建议使用Task.Run方法执行,因为Task.Run方法是将任务在线程池内进行排队执行,如果线程池线程进行长时间堵塞,会导致线程池增长,进而浪费性能,所以如果想要运行长时间的工作建议直接创建一个新线程进行工作
?下面这个例子就利用了线程池执行长时间的阻塞工作
public class QueueProcessor
{
private readonly BlockingCollection _messageQueue = new BlockingCollection();
public void StartProcessing()
{
Task.Run(ProcessQueue);
}
public void Enqueue(Message message)
{
_messageQueue.Add(message);
}
private void ProcessQueue()
{
foreach (var item in _messageQueue.GetConsumingEnumerable())
{
ProcessItem(item);
}
}
private void ProcessItem(Message message) { }
}
??所以应该改成这样
public class QueueProcessor
{
private readonly BlockingCollection _messageQueue = new BlockingCollection();
public void StartProcessing()
{
var thread = new Thread(ProcessQueue)
{
// 设置线程为背后线程,使得在主线程结束时此线程也会自动结束
IsBackground = true
};
thread.Start();
}
public void Enqueue(Message message)
{
_messageQueue.Add(message);
}
private void ProcessQueue()
{
foreach (var item in _messageQueue.GetConsumingEnumerable())
{
ProcessItem(item);
}
}
private void ProcessItem(Message message) { }
}
??线程池内线程增加会导致在执行时大量的进行上下文切换,从而浪费程序的整体性能, 线程池详细信息请参考CLR第27章
??Task.Factory.StartNew方法中有一个TaskCreationOptions参数重载,如果设置为LongRunning,则会创建一个新线程执行
// 此方法会创建一个新线程进行执行
Task.Factory.StartNew(() => { }, TaskCreationOptions.LongRunning);
4.避免使用Task.Result和Task.Wait()来堵塞线程
使用Task.Result和Task.Wait()两个方法进行阻塞异步同步化比直接同步方法阻塞还要MUCH worse(更糟),这种方式被称为Sync over async 此方式操作步骤如下
1.异步线程启动
2.调用线程调用Result或者Wait()进行阻塞
3.异步完成时,将一个延续代码调度到线程池,恢复等待该操作的代码
虽然看起来并没有什么关系,但是其实这里却是使用了两个线程来完成同步操作,这样通常会导致线程饥饿和死锁
??线程饥饿(starvation):指等待时间已经影响到进程运行,如果等待时间过长,导致进程使命没有意义时,称之为饿死
??死锁(deadlock):指两个或两个以上的线程相互争夺资源,导致进程永久堵塞,
??使用Task.Result和Task.Wait()会在winform和ASP.NET中会死锁,因为它们SynchronizationContext
具有对象,两个线程在SynchronizationContext
争夺导致死锁,而ASP.NET Core则不会产生死锁,因为ASP.NET Core本质是一个控制台应用程序,并没有上下文
?下面的例子,虽然都不会产生死锁,但是依然具有很多问题
async Task RunAsync()
{
// 此线程ID输出与UI线程ID不一致
Debug.WriteLine("UI线程:"+Thread.CurrentThread.ManagedThreadId);
return await Task.Run(() => "Run");
}
string DoOperationBlocking()
{
// 这种方法虽然摆脱了死锁的问题,但是也导致了上下文问题,RunAsync不在以UI线程调用
// Result和Wait()方法如果出现异常,异常将被包装为AggregateException进行抛出,
return Task.Run(() => RunAsync()).Result;
}
}
private async void button1_Click(object sender, EventArgs e)
{
Debug.WriteLine("RunAsync:" + Thread.CurrentThread.ManagedThreadId);
Debug.WriteLine(DoOperationBlocking());
}
public string DoOperationBlocking2()
{
// 此方法也是会导致上下文问题,
// GetAwaiter()方法对异常不会包装
return Task.Run(() => RunAsync()).GetAwaiter().GetResult();
}
5.建议使用await来代替continueWith任务
在async和await,当时可以使用continueWith来延迟执行一些方法,但是continueWith并不会捕捉``SynchronizationContext
,所以建议使用await代替continueWith
?下面例子就是使用continueWith
private void button1_Click(object sender, EventArgs e)
{
Debug.WriteLine("UI线程:" + Thread.CurrentThread.ManagedThreadId);
RunAsync().ContinueWith(task =>
{
Console.WriteLine("RunAsync returned:"+task.Result);
// 因为是使用的continueWith,所以线程ID与UI线程并不一致
Debug.WriteLine("ContinueWith:" + Thread.CurrentThread.ManagedThreadId);
});
}
public async Task RunAsync()
{
return await Task.FromResult(1 + 1);
}
??应该使用await来代替continueWith
private async void button1_Click(object sender, EventArgs e)
{
Debug.WriteLine("UI线程:" + Thread.CurrentThread.ManagedThreadId);
Debug.WriteLine("RunAsync returned:"+ await RunAsync());
Debug.WriteLine("UI线程:" + Thread.CurrentThread.ManagedThreadId);
}
public async Task RunAsync()
{
return await Task.FromResult(1 + 1);
}
6.创建TaskCompletionSource时建议使用TaskCreationOptions.RunContinuationsAsynchronously属性
对于编写类库的人来说TaskCompletionSource
是一个具有非常重要的作用,默认情况下任务延续可能会在调用try/set(Result/Exception/Cancel)的线程上进行运行,这也就是说作为编写类库的人来说必须需要考虑上下文,这通常是非常危险,可能就会导致死锁' 线程池饥饿 *数据结构损坏(如果代码异常运行)
所以在创建TaskCompletionSourece
时,应该使用TaskCreationOption.RunContinuationAsyncchronously
参数将后续任务交给线程池进行处理
?下面例子就没有使用TaskCreationOptions.RunComtinuationsAsynchronously
,
static void Main(string[] args)
{
ThreadPool.SetMinThreads(100, 100);
Console.WriteLine("Main CurrentManagedThreadId:" + Environment.CurrentManagedThreadId);
var tcs = new TaskCompletionSource();
// 使用TaskContinuationOptions.ExecuteSynchronously来测试延续任务
ContinueWith(1, tcs.Task);
// 测试await延续任务
ContinueAsync(2, tcs.Task);
Task.Run(() =>
{
Console.WriteLine("Task Run CurrentManagedThreadId:" + Environment.CurrentManagedThreadId );
tcs.TrySetResult(true);
});
Console.ReadLine();
}
static void print(int id) => Console.WriteLine($"continuation:{id}\tCurrentManagedThread:{Environment.CurrentManagedThreadId}");
static async Task ContinueAsync(int id, Task task)
{
await task.ConfigureAwait(false);
print(id);
}
static Task ContinueWith(int id, Task task)
{
return task.ContinueWith(
t => print(id),
CancellationToken.None, TaskContinuationOptions.ExecuteSynchronously, TaskScheduler.Default);
}
??所以应该改为使用TaskCreationOptions.RunComtinuationsAsynchronously
参数进行设置TaskCompletionSoure
static void Main(string[] args)
{
ThreadPool.SetMinThreads(100, 100);
Console.WriteLine("Main CurrentManagedThreadId:" + Environment.CurrentManagedThreadId);
var tcs = new TaskCompletionSource(TaskCreationOptions.RunContinuationsAsynchronously);
// 使用TaskContinuationOptions.ExecuteSynchronously来测试延续任务
ContinueWith(1, tcs.Task);
// 测试await延续任务
ContinueAsync(2, tcs.Task);
Task.Run(() =>
{
Console.WriteLine("Task Run CurrentManagedThreadId:" + Environment.CurrentManagedThreadId);
tcs.TrySetResult(true);
});
Console.ReadLine();
}
static void print(int id) => Console.WriteLine($"continuation:{id}\tCurrentManagedThread:{Environment.CurrentManagedThreadId}");
static async Task ContinueAsync(int id, Task task)
{
await task.ConfigureAwait(false);
print(id);
}
static Task ContinueWith(int id, Task task)
{
return task.ContinueWith(
t => print(id),
CancellationToken.None, TaskContinuationOptions.ExecuteSynchronously, TaskScheduler.Default);
}
??TaskCreationOptions.RunContinuationsAsynchronously
属性和TaskContinuationOptions.RunContinuationsAsynchronously
很相似,但请注意它们的使用方式
7.建议使用CancellationTokenSource(s)进行超时管理时总是释放(dispose)
用于进行超时的CancellationTokenSources,如果不释放,则会增加timer queue(计时器队列)
的压力
?下面例子因为没有释放,所以在每次请求发出之后,计时器在队列中停留10秒钟
public async Task HttpClientAsyncWithCancellationBad()
{
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10));
using (var client = _httpClientFactory.CreateClient())
{
var response = await client.GetAsync("http://backend/api/1", cts.Token);
return await response.Content.ReadAsStreamAsync();
}
}
??所以应该及时的释放CancellationSoure,使得正确的从队列中删除计时器
public async Task HttpClientAsyncWithCancellationGood()
{
using (var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10)))
{
using (var client = _httpClientFactory.CreateClient())
{
var response = await client.GetAsync("http://backend/api/1", cts.Token);
return await response.Content.ReadAsStreamAsync();
}
}
}
??设置延迟时间具有两种方式
1.构造器参数
public CancellationTokenSource(TimeSpan delay); public CancellationTokenSource(int millisecondsDelay);
2.调用实例对象CancelAfter()
public void CancelAfter(TimeSpan delay);
public void CancelAfter(int millisecondsDelay);
8.建议将协作式取消对象(CancellationToken)传递给所有使用到的API
由于在.NET中取消操作必须显示的传递CancellationToken
,所以如果想取消所有调用的异步函数,那么应该将CancllationToken
传递给此调用链中的所有函数
?下面例子在调用ReadAsync时并没有传递CancellationToken
,所以不能有效的取消
public async Task DoAsyncThing(CancellationToken cancellationToken = default)
{
byte[] buffer = new byte[1024];
// 使用FileOptions.Asynchronous参数指定异步通信
using(Stream stream = new FileStream(
@"d:\资料\Blogs\Task\TaskTest",
FileMode.OpenOrCreate,
FileAccess.ReadWrite,
FileShare.None,
1024,
options:FileOptions.Asynchronous))
{
// 由于并没有将cancellationToken传递给ReadAsync,所以无法进行有效的取消
int read = await stream.ReadAsync(buffer, 0, buffer.Length);
return Encoding.UTF8.GetString(buffer, 0, read);
}
}
??所以应该将CancellationToken
传递给ReadAsync(),以达到有效的取消
public async Task DoAsyncThing(CancellationToken cancellationToken = default)
{
byte[] buffer = new byte[1024];
// 使用FileOptions.Asynchronous参数指定异步通信
using(Stream stream = new FileStream(
@"d:\资料\Blogs\Task\TaskTest",
FileMode.OpenOrCreate,
FileAccess.ReadWrite,
FileShare.None,
1024,
options:FileOptions.Asynchronous))
{
// 由于并没有将cancellationToken传递给ReadAsync,所以无法进行有效的取消
int read = await stream.ReadAsync(buffer, 0, buffer.Length,cancellationToken);
return Encoding.UTF8.GetString(buffer, 0, read);
}
}
??在使用异步IO时,应该将options参数设置为FileOptions.Asynchronous,否则会产生额外的线程浪费,详细信息请参考CLR中28.12节
9.建议取消那些不会自动取消的操作(CancellationTokenRegistry,timer)
在异步编程时出现了一种模式cancelling an uncancellable operation,这个用于取消像CancellationTokenRegistry
和timer
这样的东西,通常是在被取消或超时时创建另外一个线程进行操作,然后使用Task.WhenAny进行判断是完成还是被取消了
使用CancellationToken
:x: 下面例子使用了Task.delay(-1,token)创建在触发CancellationToken时触发的任务,但是如果CancellationToken不触发,则没有办法释放CancellationTokenRegistry,就有可能会导致内存泄露
public static async Task WithCancellation(this Task task, CancellationToken cancellationToken)
{
// 没有方法释放cancellationToken注册
var delayTask = Task.Delay(-1, cancellationToken);
var resultTask = await Task.WhenAny(task, delayTask);
if (resultTask == delayTask)
{
// 取消异步操作
throw new OperationCanceledException();
}
return await task;
}
:ballot_box_with_check:所以应该改成下面这样,在任务一完成,就释放CancellationTokenRegistry
public static async Task WithCancellation(this Task task, CancellationToken cancellationToken)
{
var tcs = new TaskCompletionSource
使用超时任务
:x:下面这个例子即使在操作完成之后,也不会取消定时器,这也就是说最终会在计时器队列中产生大量的计时器,从而浪费性能
public static async Task TimeoutAfter(this Task task, TimeSpan timeout)
{
var delayTask = Task.Delay(timeout);
var resultTask = await Task.WhenAny(task, delayTask);
if (resultTask == delayTask)
{
// 取消异步操作
throw new OperationCanceledException();
}
return await task;
}
:ballot_box_with_check:应改成下面这样,这样将在任务完成之后,取消计时器的操作
public static async Task TimeoutAfter(this Task task, TimeSpan timeout)
{
using (var cts = new CancellationTokenSource())
{
var delayTask = Task.Delay(timeout, cts.Token);
var resultTask = await Task.WhenAny(task, delayTask);
if (resultTask == delayTask)
{
// 取消异步操作
throw new OperationCanceledException();
}
else
{
// 取消计时器任务
cts.Cancel();
}
return await task;
}
}
10.使用StreamWriter(s)或Stream(s)时在Dispose之前建议先调用FlushAsync
当使用Stream和StreamWriter进行异步写入时,底层数据也有可能被缓冲,当数据被缓冲时,Stream和StreamWriter将使用同步的方式进行write/flush
,这将会导致线程阻塞,并且有可能导致线程池内线程不足(线程池饥饿)
?下面例子由于没有调用FlushAsync(),所以最后是以同步方式进行write/flush的
public async static Task RunAsync()
{
using (var streamWriter = new StreamWriter(@"C:\资料\Blogs\Task"))
{
// 由于没有调用FlushAsync,所以最后是以同步方式进行write/flush的
await streamWriter.WriteAsync("Hello World");
}
}
??所以应该改为下面这样,在Dispose之前调用FlushAsync()
public async static Task RunAsync()
{
using (var streamWriter = new StreamWriter(@"C:\资料\Blogs\Task"))
{
await streamWriter.WriteAsync("Hello World");
// 调用FlushAsync() 使其使用异步write/flush
await streamWriter.FlushAsync();
}
}
11.建议使用 async/await而不是直接返回Task
使用async/await 代替直接返回Task具有以上好处
- 异步和同步的异常都被始终被规范为了异步
- 代码更容易修改(例如:增加一个
using
) - 异步的方法诊断起来更加容易(例如:调试,挂起)
- 抛出的异常将自动包装在返回的任务之中,而不是抛出实际异常
?下面这个错误的例子是将Task直接返回给了调用者
public Task RunAsync()
{
return Task.FromResult(1 + 1);
}
??所以应该使用async/await来代替返回Task
public async Task RunAsync()
{
return await Task.FromResult(1 + 1);
}
??使用async/await来代替返回Task时,还有性能上的考虑,虽然直接Task会更快,但是最终却改变了异步的行为,失去了异步状态机的一些好处
使用场景
1. 使用定时器回调函数
?下面例子使用一个返回值为void的异步,将其传递给Timer进行,因此,如果其中任务抛出异常,则整个进程将退出
public class Pinger
{
private readonly Timer _timer;
private readonly HttpClient _client;
public Pinger(HttpClient client)
{
_client = new HttpClient();
_timer = new Timer(Heartbeat, null, 1000, 1000);
}
public async void Heartbeat(object state)
{
await httpClient.GetAsync("http://mybackend/api/ping");
}
}
?下面例子将阻止计时器回调,这有可能导致线程池中线程耗尽,这也是一个异步差于同步的例子
public class Pinger
{
private readonly Timer _timer;
private readonly HttpClient _client;
public Pinger(HttpClient client)
{
_client = new HttpClient();
_timer = new Timer(Heartbeat, null, 1000, 1000);
}
public void Heartbeat(object state)
{
httpClient.GetAsync("http://mybackend/api/ping").GetAwaiter().GetResult();
}
}
??下面例子是使用基于的异步的方法,并在定时器回调函数中丢弃该任务,并且如果此方法抛出异常,则也不会关闭进程,而是会触发TaskScheduler.UnobservedTaskException
事件
public class Pinger
{
private readonly Timer _timer;
private readonly HttpClient _client;
public Pinger(HttpClient client)
{
_client = new HttpClient();
_timer = new Timer(Heartbeat, null, 1000, 1000);
}
public void Heartbeat(object state)
{
_ = DoAsyncPing();
}
private async Task DoAsyncPing()
{
// 异步等待
await _client.GetAsync("http://mybackend/api/ping");
}
2.创建回调函数参数时注意避免 async void
假如有BackgroudQueue
类中有一个接收回调函数的FireAndForget
方法,该方法在某个时候执行调用
?下面这个错误例子将强制调用者要么阻塞要么使用async void异步方法
public class BackgroundQueue
{
public static void FireAndForget(Action action) { }
}
static async Task Main(string[] args)
{
var httpClient = new HttpClient();
// 因为方法类型是Action,所以只能使用async void
BackgroundQueue.FireAndForget(async () =>
{
await httpClient.GetAsync("http://pinger/api/1");
});
}
??所以应该构建一个回调异步方法的重载
public class BackgroundQueue
{
public static void FireAndForget(Action action) { }
public static void FireAndForget(Func action) { }
}
3.使用ConcurrentDictionary.GetOrAdd注意场景
缓存异步结果是一种很常见的做法,ConcurrentDictionary是一个很好的集合,而GetOrAdd也是一个很方便的方法,它用于尝试获取已经存在的项,如果没有则添加项.因为回调是同步的,所以很容易编写Task.Result
的代码,从而生成异步的结果值,但是这样很容易导致线程池饥饿
?下面这个例子就有可能导致线程池饥饿,因为当如果没有缓存人员数据时,将阻塞请求线程
public class PersonController : Controller
{
private AppDbContext _db;
private static ConcurrentDictionary _cache = new ConcurrentDictionary();
public PersonController(AppDbContext db)
{
_db = db;
}
public IActionResult Get(int id)
{
// 如果不存在缓存数据,则会进入堵塞状态
var person = _cache.GetOrAdd(id, (key) => db.People.FindAsync(key).Result);
return Ok(person);
}
}
??可以改成缓存线程本身,而不是结果,这样将不会导致线程池饥饿
public class PersonController : Controller
{
private AppDbContext _db;
private static ConcurrentDictionary> _cache = new ConcurrentDictionary>();
public PersonController(AppDbContext db)
{
_db = db;
}
public async Task Get(int id)
{
// 因为缓存的是线程本身,所以没有进行堵塞,也就不会产生线程池饥饿
var person = await _cache.GetOrAdd(id, (key) => db.People.FindAsync(key));
return Ok(person);
}
}
??这种方法,在最后,GetOrAdd()可能并行多次来执行缓存回调,这可能导致启动多次昂贵的计算
??可以使用async lazy
模式来取代多次执行回调问题
public class PersonController : Controller
{
private AppDbContext _db;
private static ConcurrentDictionary> _cache = new ConcurrentDictionary>();
public PersonController(AppDbContext db)
{
_db = db;
}
public async Task Get(int id)
{
// 使用Lazy进行了延迟加载(使用时调用),解决了多次执行回调问题
var person = await _cache.GetOrAdd(id, (key) => new AsyncLazy(() => db.People.FindAsync(key)));
return Ok(person);
}
private class AsyncLazy : Lazy>
{
public AsyncLazy(Func> valueFactory) : base(valueFactory)
{
}
}
4.构造函数对于异步的问题
构造函数是同步,下面看看在构造函数中处理异步情况
下面是使用客户端API的例子,当然,在使用API之前需要异步进行连接
public interface IRemoteConnectionFactory
{
Task ConnectAsync();
}
public interface IRemoteConnection
{
Task PublishAsync(string channel, string message);
Task DisposeAsync();
}
?下面例子使用Task.Result在构造函数中进行连接,这有可能导致线程池饥饿和死锁现象
public class Service : IService
{
private readonly IRemoteConnection _connection;
public Service(IRemoteConnectionFactory connectionFactory)
{
_connection = connectionFactory.ConnectAsync().Result;
}
}
??正确的方式应该使用静态工厂模式进行异步连接
public class Service : IService
{
private readonly IRemoteConnection _connection;
private Service(IRemoteConnection connection)
{
_connection = connection;
}
public static async Task CreateAsync(IRemoteConnectionFactory connectionFactory)
{
return new Service(await connectionFactory.ConnectAsync());
}
}
原文地址:https://github.com/davidfowl/AspNetCoreDiagnosticScenarios/blob/93e39b8f48169cce4803615519ef87bb2a969c8e/AsyncGuidance.md#prefer-taskfromresult-over-taskrun-for-pre-computed-or-trivially-computed-data