未实现IRequestHandler接口问题及Mediatr中CancellationToken作用咨询

我之前也踩过Mediatr的这个坑！先给你把问题拆成两部分讲清楚：

这个令牌是异步操作里的「终止开关」，核心作用就是优雅地取消正在执行的任务：

• 比如用户发起存记录的请求后，中途关掉页面或者点击了取消按钮，Mediatr会触发这个令牌的取消信号，你可以在Handle方法里检查cancellationToken.IsCancellationRequested，提前终止数据库操作，避免浪费服务器资源。
• 在EF Core这类ORM里，你还能把这个令牌直接传给异步数据库方法（比如SaveChangesAsync(cancellationToken)），当任务被取消时，数据库操作也会跟着终止，不会留下半拉子的操作。
• 它还能用来处理超时场景，比如你可以在调用Mediatr的时候设置超时，超时后自动触发取消。

这个错误99%是因为你的Handle方法签名和IRequestHandler接口的定义差了一点点细节，哪怕参数顺序、返回值类型不对都会触发。先看接口的标准定义：

Task<TResponse> Handle(TRequest request, CancellationToken cancellationToken);

你可以对照检查这几个常见问题：

1. 漏加CancellationToken参数：哪怕你暂时用不上这个令牌，也必须把它作为第二个参数写到方法里，接口要求必须有。
2. 返回值不匹配：比如你的Command是带返回值的IRequest<TResponse>，但Handle方法返回了Task而不是Task<TResponse>；或者反过来，Command不带返回值，但你返回了带泛型的Task。
3. 没加async关键字：如果你的Handle方法里用了await（比如调用EF的异步方法），必须给方法加async，否则返回的Task类型会不匹配。

给你贴一个正确的完整示例，你可以对照调整：

第一步：定义请求（Command）和返回对象 #

// 要执行的任务：存入数据库的请求
public class SaveRecordCommand : IRequest<SaveRecordResult>
{
    // 你的记录字段，比如：
    public string Title { get; set; }
    public string Content { get; set; }
}

// 操作结果返回
public class SaveRecordResult
{
    public bool Success { get; set; }
    public int RecordId { get; set; }
}

第二步：正确实现Handler #

public class SaveRecordCommandHandler : IRequestHandler<SaveRecordCommand, SaveRecordResult>
{
    private readonly AppDbContext _dbContext;

    // 通过依赖注入拿到数据库上下文
    public SaveRecordCommandHandler(AppDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    // 严格匹配接口签名：async + Task<SaveRecordResult> + 两个参数
    public async Task<SaveRecordResult> Handle(SaveRecordCommand request, CancellationToken cancellationToken)
    {
        // 可选：提前检查是否被取消
        cancellationToken.ThrowIfCancellationRequested();

        // 创建实体存入数据库
        var newRecord = new RecordEntity
        {
            Title = request.Title,
            Content = request.Content
        };

        _dbContext.Records.Add(newRecord);
        // 把取消令牌传给数据库操作
        await _dbContext.SaveChangesAsync(cancellationToken);

        return new SaveRecordResult
        {
            Success = true,
            RecordId = newRecord.Id
        };
    }
}

如果你的操作不需要返回结果，就用IRequest（不带泛型），Handler实现IRequestHandler<SaveRecordCommand>，此时Handle方法返回Task：

public async Task Handle(SaveRecordCommand request, CancellationToken cancellationToken)
{
    // 逻辑同上，只是不用返回值
}

最后再确认一下：你的Handler类必须正确实现对应的IRequestHandler泛型接口，泛型参数要和你的Command、返回对象完全对应，这样编译器就不会报接口未实现的错误了。

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