NUnit异步测试返回Task报错：并非所有代码路径都返回值，改void也报错

DevOps 小满

2026-6-17

解决NUnit异步测试的两个常见错误

问题分析

你遇到的两个错误本质是NUnit异步测试方法的规范和环境配置问题：

使用async Task作为返回类型时，编译器提示“并非所有代码路径都返回值”——这通常是编译器误报或基础配置缺失（async Task方法无需显式返回值，默认会返回已完成的Task）。
改成async void后，NUnit提示“Async test method must have non-void return type”——NUnit 3.x及以上版本明确要求异步测试方法必须返回Task或Task<T>，禁止使用async void（会导致测试无法跟踪异步操作的完成状态）。

解决方案

1. 检查基础配置

添加必要命名空间：在测试类顶部引入using System.Threading.Tasks;，确保编译器能正确识别Task类型。
升级NNUIT版本：通过NuGet将NUnit和NUnit3TestAdapter升级到最新稳定版（≥3.0），旧版本对异步测试的支持存在缺陷。
确认目标框架兼容性：项目目标框架需为.NET Framework 4.5+、.NET Core 1.0+或.NET 5+，这些版本原生支持异步方法。

2. 修正测试代码

若配置无误仍出现编译器误报，可在方法末尾显式返回Task.CompletedTask，强制消除错误提示：

[Test]
public async Task AddColumnAsync_ShouldReturnTrue_WhenColumnIsAddedSuccessfully()
{
    // Arrange
    var column = new Column { Id = 1, Name = "To Do" };

    // Act
    var result = await _columnRepository.AddColumnAsync(column);

    // Assert
    Assert.That(result, Is.True);
    var columnFromDb = await _context.Columns.FindAsync(1);
    Assert.That(columnFromDb, Is.Not.Null);
    Assert.That(columnFromDb.Name, Is.EqualTo("To Do"));

    // 显式返回已完成任务，解决编译器误报
    return Task.CompletedTask;
}