You need to enable JavaScript to run this app. 基于Mediatr的CQRS+DDD下AuthenticateUserQuery是否为合法Query?
优惠活动
大模型
产品
解决方案
定价
更多

基于Mediatr的CQRS+DDD下AuthenticateUserQuery是否为合法Query?

CQRS+DDD架构下用户认证功能的落地解答

1. AuthenticateUserQuery的定位判定

你当前设计的实现完全属于CQRS定义下的合法Query,不需要实现为Domain Service。
原因很直接:

  • 整个操作没有任何写副作用:不修改聚合状态、不写库、不触发领域事件,只是从读链路拿用户凭证做校验,完全符合CQRS对Query“无副作用、面向读场景”的核心要求。
  • Domain Service是用来承载跨聚合的领域逻辑的——也就是那些没法归属到单个聚合根的规则,比如下单的时候要同时扣库存、算用户折扣、检查用户信用,这种跨多个聚合的业务逻辑才需要放领域服务。你现在的密码校验只是从读端拿个哈希值比对,根本不需要碰写端的User聚合,没必要为了凑DDD的层级硬把简单逻辑抬到领域服务里,徒增复杂度。

2. UserAuthResult的定位

这东西就是ReadModel。
别把ReadModel想的太复杂,它不是必须和数据库表一一对应的实体,只要是专门为读场景设计、不承载业务行为、只用来传输数据的对象,都是ReadModel。你这个UserAuthResult是专门给客户端返回认证结果的,完全符合定义。

3. UserAuthDetailReadModel的定位

也是ReadModel。
不管这个读模型是给外部客户端返回的,还是给Query Handler内部用的中间对象,只要是从Reader读链路获取的、没有业务行为、专门为读场景设计的,都算ReadModel。你这个UserAuthDetailReadModel就是用来存密码哈希、用户状态这些校验需要的内部字段,不需要对外暴露,本质还是读模型。

4. Query的命名规范

完全可以不用CRUD前缀。
CQRS的命名核心是说清楚“操作要实现的业务意图”,不是必须套Get/Create/Update这类模板。你叫AuthenticateUserQuery,大家一看就知道这是做认证校验的,比硬叫GetUserAuthDetailQuery靠谱多了——后者只会让别人以为你只是查个用户详情就返回,根本不知道你还要做密码比对。
实际项目里只要命名能让团队一眼看懂意图就行,像ValidatePermissionQuery、RefreshTokenQuery这种不带Get的命名,都是通用写法,没有任何规范问题。

5. 若需实现Domain Service的落地规范

只有一种情况你需要做Domain Service:就是你的认证逻辑要和写端的User聚合强绑定,还要修改聚合状态——比如连续输错5次密码就要锁定用户账户,这种带写操作的逻辑,才需要考虑领域服务的设计,规范如下:

  • Domain Service放在领域层,是无状态的,不要丢到应用层或者读层去。
  • 依赖只认领域层的抽象接口,别直接硬依赖DbContext、读端Reader这些基础设施组件。
  • 方法参数只传业务需要的内容,别把基础设施的实现直接当参数塞进去。

举个实际的代码例子:

// 领域层定义的抽象接口,具体实现交给基础设施层
public interface IUserCredentialProvider
{
    Task<UserCredential?> GetCredentialAsync(string userId, CancellationToken ct);
}

// 领域服务实现
public class UserAuthenticationDomainService
{
    public async Task<bool> ValidateCredentialAsync(
        string userId,
        string inputPassword,
        IUserCredentialProvider credentialProvider,
        CancellationToken ct)
    {
        var credential = await credentialProvider.GetCredentialAsync(userId, ct);
        if (credential == null) return false;
        // 密码哈希校验属于核心领域规则,放在领域层
        return PasswordHasher.VerifyHash(inputPassword, credential.PasswordHash);
    }
}

注意:这个Domain Service是给写链路的Command Handler用的,比如你要做“认证成功后记录用户最后登录时间”的操作,Command Handler里调用这个服务做校验,然后修改User聚合,别把它塞到Query Handler里用。

6. 其他边界场景的设计规则

如果操作既不符合Query的定义,也没必要做Domain Service,一般是两种情况,对应处理规则很简单:

  • 如果操作带写副作用(比如认证成功要更新最后登录时间、刷新令牌):直接拆链路。校验的部分走现在的AuthenticateUserQuery,写的部分单独做Command(比如UpdateUserLastLoginTimeCommand)走写链路,通过Repository操作User聚合,绝对不能在Query Handler里写任何改库的逻辑,这是CQRS的红线。
  • 如果校验逻辑要跨好几个读源(比如既要查本地用户状态,又要查IP黑名单、风控规则):直接把这些聚合逻辑丢到当前的Query Handler里就行,别抬成Domain Service——这些都是读链路的应用层逻辑,不涉及领域规则的流转,没必要增加层级。

实践踩坑提醒

  • 写端User聚合里的密码一定要存加盐哈希,别存明文,哈希生成的逻辑放创建用户的Command里,校验逻辑放认证的Query里就行。
  • 别为了凑DDD的概念硬把简单逻辑下沉到领域服务,很多团队搞CQRS+DDD最后复杂度爆炸,都是在没必要的地方堆了太多层级。

内容的提问来源于stack exchange,提问作者Bear MAN

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.02 21:45:04