0

0

C# 异步方法单元测试方法 C#如何测试一个async方法

月夜之吻

月夜之吻

发布时间:2026-02-21 08:11:02

|

207人浏览过

|

来源于php中文网

原创

异步测试必须用async task方法声明,避免void或同步task;禁用.result/wait()防死锁;mock需返回task.fromresult或returnsasync;断言须用await assert.throwsasync。

c# 异步方法单元测试方法 c#如何测试一个async方法

async方法测试必须用async Task方法声明

同步的voidTask测试方法无法正确等待异步操作完成,会导致测试提前结束、断言失效或偶发失败。xUnit/NUnit/MSTest都要求测试方法本身是async Task,否则await会被当作同步调用处理。

  • ✅ 正确写法:public async Task MyMethod_ShouldReturnExpectedResult()
  • ❌ 错误写法:public void MyMethod_ShouldReturnExpectedResult()public Task MyMethod_ShouldReturnExpectedResult()
  • 如果用 MSTest,还需在方法上加 [TestMethod];xUnit 则用 [Fact][Theory]

避免直接调用Result或Wait()引发死锁

在测试中对Task对象调用.Result.Wait(),尤其在有同步上下文(如默认的 UI 线程或 ASP.NET 同步上下文)的测试运行器里,极易触发死锁——因为 await 在捕获上下文后尝试回调回原上下文,而该上下文正被Wait()阻塞。

NotebookLM
NotebookLM

Google推出的AI笔记应用工具

下载
  • 永远用 await myAsyncMethod(),而不是 myAsyncMethod().Result
  • 若需兼容旧框架(如 .NET Framework 4.6.1 以下),可临时用 ConfigureAwait(false) 降低风险,但治标不治本
  • Mock 异步依赖时,确保返回的是真正可 await 的 Task,比如 Moq 中用 Task.FromResult(…) 而非直接 return 值

Mock 异步依赖要用 Task.FromResult 或 ReturnsAsync

测试 async 方法时,常需隔离外部 I/O(如 HTTP 调用、数据库访问)。若 mock 返回普通值而非 Task,运行时会报错“无法将 T 隐式转换为 Task”。

  • Moq 用户:用 mock.Setup(x => x.GetAsync()).ReturnsAsync(result)(推荐)或 Task.FromResult(result)
  • NSubstitute 用户:用 substitute.GetAsync().Returns(Task.FromResult(result))
  • 注意:不要写 Returns(result),这会让方法签名不匹配,编译可能过,但运行时抛 InvalidCastException

异常断言要用 await + Assert.ThrowsAsync

异步方法抛出的异常被包装在 Task 内部,不能用 Assert.ThrowsException<exceptiontype>(() => …)</exceptiontype> 这种同步断言方式——它只会捕获同步阶段抛出的异常,而 await 后的异常根本不会触发。

  • ✅ 正确:await Assert.ThrowsAsync<invalidoperationexception>(async () => await target.DoWorkAsync())</invalidoperationexception>
  • ❌ 错误:Assert.ThrowsException<invalidoperationexception>(() => target.DoWorkAsync().Wait())</invalidoperationexception>(绕过 await,且易死锁)
  • 部分测试框架(如 xUnit)的 ThrowsAsync 是泛型方法,类型参数必须精确匹配,比如 ArgumentExceptionArgumentNullException 不等价
实际测试中最容易被忽略的,是测试运行器自身的同步上下文行为——哪怕代码逻辑完全正确,换一个测试发现器(比如从 Visual Studio Test Explorer 切到 dotnet test CLI),也可能因上下文差异导致间歇性失败。务必统一使用 async Task 测试方法 + await + ThrowsAsync 这套组合,别为了“看着快”去碰 ResultGetAwaiter().GetResult()

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
javascriptvoid(o)怎么解决
javascriptvoid(o)怎么解决

javascriptvoid(o)的解决办法:1、检查语法错误;2、确保正确的执行环境;3、检查其他代码的冲突;4、使用事件委托;5、使用其他绑定方式;6、检查外部资源等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

183

2023.11.23

java中void的含义
java中void的含义

本专题整合了Java中void的相关内容,阅读专题下面的文章了解更多详细内容。

119

2025.11.27

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

695

2023.08.10

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

374

2023.06.29

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2093

2023.08.14

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

356

2023.08.31

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

259

2023.09.05

vb中怎么连接access数据库
vb中怎么连接access数据库

vb中连接access数据库的步骤包括引用必要的命名空间、创建连接字符串、创建连接对象、打开连接、执行SQL语句和关闭连接。本专题为大家提供连接access数据库相关的文章、下载、课程内容,供大家免费下载体验。

329

2023.10.09

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

796

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 9.9万人学习

C 教程
C 教程

共75课时 | 4.9万人学习

C++教程
C++教程

共115课时 | 18.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号