讲师中心 微信公众号
AI工具推荐 视频效率加速

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

云雪小哥_5259

云雪小哥_5259

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

|

247人浏览过

|

来源于php中文网

原创

异步测试必须用async Task方法声明,避免void或同步Task;禁用.Result/Wait()防死锁;Mock需返回Task.FromResult或ReturnsAsync;断言须用await Assert.ThrowsAsync。

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

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

同步的void或Task测试方法无法正确等待异步操作完成,会导致测试提前结束、断言失效或偶发失败。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()阻塞。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 永远用 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 是泛型方法,类型参数必须精确匹配,比如 ArgumentException 和 ArgumentNullException 不等价
实际测试中最容易被忽略的,是测试运行器自身的同步上下文行为——哪怕代码逻辑完全正确,换一个测试发现器(比如从 Visual Studio Test Explorer 切到 dotnet test CLI),也可能因上下文差异导致间歇性失败。务必统一使用 async Task 测试方法 + await + ThrowsAsync 这套组合,别为了“看着快”去碰 Result 或 GetAwaiter().GetResult()。

热门AI工具

更多
讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

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

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

636

2023.11.23

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

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

371

2025.11.27

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

391

2026.03.13

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

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

4638

2023.08.10

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

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

3025

2023.06.29

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

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

4121

2023.08.14

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

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

3391

2023.08.31

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

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

1067

2023.09.05

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn