使用Moq为C#异步方法编写测试时遇到await无返回问题

看起来你遇到了Moq模拟异步依赖时的典型坑——如果没有正确设置异步方法的返回值，await会一直等待一个永远不会完成的Task，导致测试卡住。我来帮你梳理常见问题和解决办法：

最常见的错误：未正确设置异步返回值 #

Moq对于异步方法（返回Task或Task<T>），默认会返回一个未完成的空Task。如果你的GetRepository方法里没有给UpdateItemAsync设置明确的返回值，await就会一直阻塞在这里。

正确的设置方式 #

假设你的仓库接口是类似这样的：

public interface IItemRepository
{
    Task<object> UpdateItemAsync(string id, object item);
}

那你的GetRepository应该这样写，用ReturnsAsync来指定异步返回的结果：

private IItemRepository GetRepository()
{
    var mockRepo = new Mock<IItemRepository>();
    
    // 匹配任意参数，并返回一个已完成的Task，携带你期望的结果
    mockRepo.Setup(repo => repo.UpdateItemAsync(It.IsAny<string>(), It.IsAny<object>()))
            .ReturnsAsync(new object()); // 这里可以替换成你测试需要的具体对象
    
    return mockRepo.Object;
}

如果你的方法返回的是无返回值的Task（不是Task<T>），则用Task.CompletedTask：

mockRepo.Setup(repo => repo.SomeVoidAsyncMethod())
        .Returns(Task.CompletedTask);

另一个可能的坑：参数匹配不匹配 #

如果你的Setup里指定了具体的参数值，但测试调用时传的参数不匹配，Moq同样会返回默认的未完成Task。比如：

// Setup里指定了具体的id
mockRepo.Setup(repo => repo.UpdateItemAsync("expectedId", It.IsAny<object>()))
        .ReturnsAsync(new object());

但你的测试里传的是空字符串""，这时候匹配失败，await就会卡住。解决办法是要么让Setup的参数和测试调用完全一致，要么用It.IsAny<T>来匹配任意参数（就像上面的示例那样）。

确认测试方法的正确性 #

你已经做到了这一点，但还是提一下：测试方法必须标记为async Task（不能是async void），否则异步代码的执行会出问题，这也是常见的测试陷阱。

按照上面的方法调整你的GetRepository，应该就能解决await无法返回的问题了。

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