You need to enable JavaScript to run this app. DDD项目中使用MediatR实现CQRS时Handler未找到的错误问询
优惠活动
大模型
产品
解决方案
定价
更多

DDD项目中使用MediatR实现CQRS时Handler未找到的错误问询

核心原因

MediatR的自动注册机制只会扫描你指定范围内的程序集:

  • 你之前配置的services.AddMediatR(typeof(Startup)),本质是扫描Startup类所在的Presentation项目程序集
  • 但所有自定义的IRequestHandler实现都定义在Domain项目的程序集中,完全不在扫描范围内,因此运行时会抛出找不到对应Handler的异常
配置修改步骤

1. 定位Domain项目对应的程序集

MediatR需要明确扫描范围,你可以通过Domain项目内任意一个公开类的类型,定位到Domain所属的程序集。比如你Domain下有Product领域模型,就可以通过该类获取程序集对象:

// 利用Domain内的公开类关联所属程序集
var domainAssembly = typeof(Domain.Models.Product).Assembly;

2. 替换Startup中的MediatR注册逻辑

将原来的注册代码替换为指向Domain程序集的配置,根据你使用的MediatR版本选择对应写法:

  • MediatR V12及以上版本(当前官方推荐写法):
    services.AddMediatR(config => config.RegisterServicesFromAssembly(domainAssembly));
    
  • MediatR V11及更早版本(兼容旧示例的写法):
    services.AddMediatR(domainAssembly);
    
    你之前看到的services.AddMediatR(typeof(AddEducationCommand).GetTypeInfo().Assembly)本质也是这个逻辑——只要传入的类型所属的程序集是存放Handler的Domain程序集,就能正常扫描注册。

3. 常见排查项

如果修改注册后仍然报错,可以逐一核对以下容易踩的坑:

  • 所有Handler实现类必须是公开访问的,私有、内部类会被MediatR的扫描逻辑直接跳过
  • Handler的泛型参数必须和请求类完全匹配:比如NewProductRequest实现了IRequest<string>,对应的Handler就必须严格实现IRequestHandler<NewProductRequest, string>,泛型参数错配也会触发找不到Handler的错误
  • 确认Presentation项目已正确引用Domain项目,不存在程序集引用丢失、版本不一致的问题
  • 程序集扫描不受项目内目录结构影响,只要Handler类在Domain程序集内,不管放在哪个子文件夹下都能被正常注册,无需额外配置目录路径

内容的提问来源于stack exchange,提问作者Augusto Henrique

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.21 17:24:06