Xunit单元测试：Assert.ThrowsAnyAsync无法处理Exception派生类问题

原因分析 #

你遇到的错误本质是断言逻辑在做精确类型匹配检查，而非允许派生类的模糊匹配。虽然SocketException是Exception的派生类，但当前执行的断言方法要求抛出的异常必须是System.Exception的精确实例，而非其子类。

这种情况大概率是以下两种原因之一：

• 误将Assert.ThrowsAnyAsync写成了Assert.ThrowsAsync：ThrowsAsync<T>要求抛出的异常必须是T的精确类型，而ThrowsAnyAsync<T>才会接受T或其派生类的实例。
• 使用的xUnit版本过旧：部分早期版本的ThrowsAnyAsync存在行为偏差，未正确实现派生类的匹配逻辑。

解决方案 #

1. 核对断言方法：确认代码中调用的是Assert.ThrowsAnyAsync<Exception>(...)，而非Assert.ThrowsAsync<Exception>(...)。
2. 升级测试框架：如果确实使用的是ThrowsAnyAsync，将xUnit升级到最新稳定版，修复旧版本的行为问题。
3. 精准指定异常类型：如果测试目标就是验证SocketException的抛出，直接使用Assert.ThrowsAnyAsync<SocketException>(...)，既精准又能避免基类匹配的歧义。

修正后的示例代码 #

// 方案1：确保使用ThrowsAnyAsync捕获Exception及派生类
var ex = await Assert.ThrowsAnyAsync<Exception>(async () => await _ftpClient.GetFile("test", "test"));

// 方案2：精准捕获SocketException（更推荐）
var ex = await Assert.ThrowsAnyAsync<System.Net.Sockets.SocketException>(async () => await _ftpClient.GetFile("test", "test"));

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