MediatR 12.2.0同步Handle方法遇返回值错误的解决方案

针对你遇到的两个问题——Handle方法提示“并非所有代码路径都返回值”、添加async后出现“异步方法缺少await”警告，以下是两种实用解决方案：

方案一：返回已完成的Task（推荐，无额外开销） #

直接在同步逻辑执行完后返回Task.CompletedTask，完全符合接口的Task返回要求，且不需要使用async修饰符，不会产生异步状态机的额外开销：

public class UploadFileCommandHandler(IFileUploadingService fileUploadingService) 
    : IRequestHandler<UploadFileCommand>
{
    private readonly IFileUploadingService _fileUploadingService = fileUploadingService;

    public Task Handle(UploadFileCommand request, CancellationToken cancellationToken)
    {
        _fileUploadingService.UploadFile(request.File);
        return Task.CompletedTask; // 返回一个已完成的Task实例，满足方法签名
    }
}

方案二：保留async修饰符（适配未来异步改造） #

如果后续计划将IFileUploadingService.UploadFile改为异步方法，或者希望统一使用async风格的写法，可以保留async修饰符，通过两种方式消除警告：

方式1：抑制异步无await警告 #

使用编译器指令临时禁用CS1998警告，代码更简洁：

public class UploadFileCommandHandler(IFileUploadingService fileUploadingService) 
    : IRequestHandler<UploadFileCommand>
{
    private readonly IFileUploadingService _fileUploadingService = fileUploadingService;

#pragma warning disable CS1998 // 异步方法缺少 await 运算符，将同步运行
    public async Task Handle(UploadFileCommand request, CancellationToken cancellationToken)
    {
        _fileUploadingService.UploadFile(request.File);
    }
#pragma warning restore CS1998
}

方式2：添加无意义的await语句 #

通过await一个已完成的Task来满足异步方法的语法要求，无需修改编译器设置：

public class UploadFileCommandHandler(IFileUploadingService fileUploadingService) 
    : IRequestHandler<UploadFileCommand>
{
    private readonly IFileUploadingService _fileUploadingService = fileUploadingService;

    public async Task Handle(UploadFileCommand request, CancellationToken cancellationToken)
    {
        _fileUploadingService.UploadFile(request.File);
        await Task.CompletedTask; // 仅用于消除警告，不影响业务逻辑
    }
}

关键说明 #

MediatR 12.x中，无返回值请求对应的处理器接口IRequestHandler<TRequest>强制要求Handle方法返回Task，这是接口契约的规定，因此必须返回有效的Task实例，不能仅执行同步代码就结束方法。

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