多场景下CQRS更新命令管理的最佳实践及实现咨询

核心结论 #

你的理解完全正确——CQRS的命令必须贴合具体业务场景定制，绝对不能为了复用修改原有命令的结构，否则必然引发跨应用的兼容性问题，就像你遇到的AppA异常情况。

具体解决方案 #

拆分场景化命令是正确方向，要为每个独立业务操作创建专属命令：

1. 定义场景专属命令 #

针对AppA和AppB的不同需求，分别编写两个独立命令：

// 仅更新FirstName的命令，供AppA使用
public sealed record UpdateUserFirstNameCommand(int UserId, string FirstName) : IRequest;

// 同时更新FirstName和LastName的命令，供AppB使用
public sealed record UpdateUserFullNameCommand(int UserId, string FirstName, string LastName) : IRequest;

2. 实现独立的命令处理器 #

为每个命令编写对应的处理器，确保业务逻辑互不干扰：

// UpdateUserFirstNameCommand的处理器
public sealed class UpdateUserFirstNameCommandHandler : IRequestHandler<UpdateUserFirstNameCommand>
{
    private readonly IUserRepository _userRepository;

    public UpdateUserFirstNameCommandHandler(IUserRepository userRepository)
    {
        _userRepository = userRepository;
    }

    public async Task<Unit> Handle(UpdateUserFirstNameCommand request, CancellationToken cancellationToken)
    {
        var user = await _userRepository.GetByIdAsync(request.UserId, cancellationToken);
        if (user == null)
        {
            throw new UserNotFoundException(request.UserId);
        }

        user.UpdateFirstName(request.FirstName);
        await _userRepository.SaveChangesAsync(cancellationToken);
        return Unit.Value;
    }
}

// UpdateUserFullNameCommand的处理器
public sealed class UpdateUserFullNameCommandHandler : IRequestHandler<UpdateUserFullNameCommand>
{
    private readonly IUserRepository _userRepository;

    public UpdateUserFullNameCommandHandler(IUserRepository userRepository)
    {
        _userRepository = userRepository;
    }

    public async Task<Unit> Handle(UpdateUserFullNameCommand request, CancellationToken cancellationToken)
    {
        var user = await _userRepository.GetByIdAsync(request.UserId, cancellationToken);
        if (user == null)
        {
            throw new UserNotFoundException(request.UserId);
        }

        user.UpdateFirstName(request.FirstName);
        user.UpdateLastName(request.LastName);
        await _userRepository.SaveChangesAsync(cancellationToken);
        return Unit.Value;
    }
}

3. 跨应用共享的规范 #

• 共享类库只存放稳定的通用基础结构（比如IRequest接口、User领域实体的核心逻辑），不存放具体业务命令。
• 各应用的专属命令和处理器，放在各自应用的代码目录中；若多个应用需要同一个命令，可单独提取共享命令包，但必须严格遵循版本控制，修改前确认所有依赖方兼容。

为什么不能修改原有命令？ #

CQRS中，命令代表明确的业务操作意图，修改原有命令的参数相当于改变了这个意图的定义，会导致所有依赖它的应用出现兼容性问题。每个命令应保持原子性、贴合特定场景，这是CQRS模式下维持业务逻辑清晰的核心原则。

内容的提问来源于stack exchange，提问作者Imran Yaseen