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
相关产品推荐
相关产品推荐

