MediatR 是 .NET 进程内中介者模式的标准实现，注册须用泛型重载并显式指定程序集，IRequest非法，应选 IRequest 或 IRequest（等价 IRequest），Send 用于请求-响应，Publish 用于事件广播。
MediatR 不是“实现中介者模式的可选方案”，它就是中介者模式在 .NET 进程内消息传递的标准化落地。用错注册方式、混淆 Send 和 Publish、把 IRequest 当合法写法——这些错误会直接导致运行时崩溃或逻辑静默失效。
MediatR 注册失败：AddMediatR() 找不到扩展方法或 Handler 未注册
不是包没装，而是 v12+ 移除了无参重载。调用 AddMediatR() 报错“未找到该扩展方法”，大概率是因为只装了 MediatR 主包，漏了 MediatR.Extensions.Microsoft.DependencyInjection；即使装对了，空参数调用也会编译失败。
- 必须用泛型重载：
builder.Services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Program).Assembly)); - 若 Handler 分散在多个程序集（如
Application、Infrastructure），需显式列出：RegisterServicesFromAssemblies(typeof(CreateUserCommand).Assembly, typeof(EmailNotificationHandler).Assembly) - 漏掉任一程序集 → 运行时抛
InvalidOperationException: Handler was not found for request，且堆栈不提示缺哪个程序集，只能靠日志或断点查cfg.ServiceClosures
IRequest 和 IRequest 到底怎么选
关键不在“有没有返回值”，而在“调用方是否需要同步等待并消费结果”。写成 IRequest 会编译失败，这不是疏忽，是类型系统在拦你。
-
IRequest：必须有非-void 返回类型，比如Guid、UserDto；想表示“执行成功但无业务数据”，用IRequest（Unit是 MediatR 自带的不可变占位类型） -
IRequest（无泛型）：等价于IRequest，语义更清晰，推荐用于纯副作用操作（如发短信、触发 webhook） - 错误示范：
public record CreateUserCommand() : IRequest→ 编译报错；正确写法是IRequest或IRequest
Send vs Publish：命令和事件不能混用
Send 是请求-响应模型，Publish 是事件广播模型。强行用 Send 发领域事件，或用 Publish 调用命令处理逻辑，会导致行为不可控甚至死锁。
-
Send：严格一对一，只找一个() IRequestHandler，等待其完成并返回结果；适用于 CQRS 中的 Command 和 Query -
Publish()：一对多，所有INotificationHandler都会被调用，默认并行执行，不等待全部完成；适用于领域事件（如UserCreatedNotification） - 陷阱：在
INotificationHandler里调用_mediator.Send(...)可能引发递归（尤其当通知触发新命令，命令又发通知）；加守卫条件或用CancellationToken限深
Mediator 实例为 null：DI 注入失败的典型表现
最常见不是代码写错，而是生命周期或注册顺序问题。比如在 Program.cs 提前用了 builder.Services.BuildServiceProvider().GetRequiredService，此时 DI 容器尚未完成构建，IMediator 就是 null。
- 确保
AddMediatR在AddControllers或AddEndpointsApiExplorer之前调用 - 不要在静态字段/构造函数中直接访问
IMediator；若必须提前获取，改用IServiceProvider延迟解析 - 在 Handler 构造函数里加守卫：
if (mediator == null) throw new ArgumentNullException(nameof(mediator));，比运行时 NullReferenceException 更早暴露问题
真正难的不是写几个 IRequestHandler，而是搞清每个消息的语义归属：它到底是个要结果的请求，还是个只管发出去的通知？注册时漏一个程序集，整个链路就断在生产环境凌晨三点——而错误日志里只有一行“Handler was not found”。
