基于Mediatr的CQRS+DDD下AuthenticateUserQuery是否为合法Query?
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

