ErrorOr库中的多错误处理机制探讨

引言

在现代C#应用程序开发中，优雅地处理错误和异常是构建健壮系统的关键。ErrorOr库提供了一种函数式的方式来处理操作结果，它允许方法返回一个包含成功值或错误集合的结果对象。然而，在实际开发中，我们经常需要处理多个可能产生错误的操作，并将这些错误聚合起来统一处理。

传统多错误处理方式

在ErrorOr库的传统使用方式中，当我们需要处理多个可能产生错误的操作时，代码往往会显得冗长且重复。例如：

public static ErrorOr<SomeResult> Create(string value1, string value2)
{
    ErrorOr<Value1> value1OrError = Value1.Create(value1);
    ErrorOr<Value2> value2OrError = Value2.Create(value2);
    var errors = new List<Error>();
    errors.AddRange(value1OrError.Errors);
    errors.AddRange(value2OrError.Errors);

    if(errors.Count > 0) {
        return errors;
    }

    return new SomeResult(value1OrError.Value, value2OrError.Value);
}

这种方式虽然可行，但存在几个问题：

1. 需要手动创建错误列表并逐个添加
2. 错误检查逻辑重复
3. 代码可读性较差

改进方案探讨

社区提出了几种改进方案来简化多错误处理的流程，使代码更加简洁和表达性更强。

方案一：ErrorCollector类

public static ErrorOr<SomeResult> Create(string value1, string value2)
{
    ErrorOr<Value1> value1OrError = Value1.Create(value1);
    ErrorOr<Value2> value2OrError = Value2.Create(value2);

    return ErrorCollector
       .Collect(value1OrError, value2OrError)
       .Then(x => new SomeResult(value1OrError.Value, value2OrError.Value));
}

方案二：ErrorOrFactory扩展

public static ErrorOr<SomeResult> Create(string value1, string value2)
{
    ErrorOr<Value1> value1OrError = Value1.Create(value1);
    ErrorOr<Value2> value2OrError = Value2.Create(value2);

    return ErrorOrFactory
       .CollectErrors(value1OrError, value2OrError)
       .Then(() => new SomeResult(value1OrError.Value, value2OrError.Value));
}

这两种方案都通过引入一个集中处理错误的机制，显著提高了代码的可读性和可维护性。

实现原理

核心的实现思路是检查所有传入的ErrorOr对象，收集其中的错误信息：

public static ErrorOr<Result> CollectErrors<Result>(params IErrorOr[] errorsToCombine)
{
    if (errorsToCombine.Any(x => x.IsError))
    {
        return errorsToCombine.SelectMany(x => x.Errors);
    }

    return Result.Success;
}

这个实现有几个关键点：

1. 使用params关键字接受可变数量的参数
2. 检查是否有任何错误存在
3. 使用SelectMany扁平化所有错误集合
4. 如果没有错误，返回成功结果

实际应用案例

在实际应用中，这种多错误处理机制特别适用于表单验证、领域模型验证等场景。例如用户注册时，需要验证用户名、密码、邮箱等多个字段：

public ErrorOr<User> Register(string username, string password, string email)
{
    return ErrorCollector
        .Collect(
            ValidateUsername(username),
            ValidatePassword(password),
            ValidateEmail(email)
        )
        .Then(() => new User(username, password, email));
}

高级用法：结合Then链式调用

ErrorOr的强大之处在于可以结合Then方法实现链式调用，处理多个异步操作：

public async Task<ErrorOr<TransactionUpdateResult>> UpdateTransaction(
    ISender sender, 
    UpdateRequest request,
    CancellationToken cancellationToken)
{
    return await sender.Send(new UserQuery(request.UserExternalId), cancellationToken)
        .Then(user => (user, sender.Send(new TransactionQuery(request.TransactionId), cancellationToken)))
        .ThenAsync(async tuple => {
            var (user, transaction) = tuple;
            // 使用user和transaction进行业务处理
            return new TransactionUpdateResult(/*...*/);
        });
}

自定义扩展方法

对于更灵活的使用场景，可以创建自定义扩展方法：

public static class ErrorExtensions
{
    public static List<Error> Combine(params IErrorOr[] errorOrs) =>
        errorOrs
            .Where(x => x.IsError)
            .Where(x => x.Errors is not null)
            .SelectMany(x => x.Errors!)
            .ToList();
}

使用示例：

ErrorOr<Success> UpdateUser(User user)
{
    if (ErrorExtensions.Combine(
        user.SetFirstName(firstName),
        user.SetLastName(lastName)
    ) is var errors && errors.Count > 0)
    {
        return errors;
    }
    
    return Result.Success;
}

最佳实践建议

1. 命名一致性：无论采用哪种方案，保持项目中的命名一致性很重要
2. 空值处理：确保实现中正确处理null值情况
3. 性能考虑：对于高频调用的场景，考虑使用更高效的集合操作
4. 错误排序：如果需要保持错误顺序，注意收集方式的稳定性
5. 异步支持：考虑提供异步版本的收集方法

结论

ErrorOr库的多错误处理机制通过提供更简洁、更表达性的API，显著改善了C#中错误处理的体验。无论是采用内置的解决方案还是自定义扩展，都能使代码更加清晰、更易于维护。这种模式特别适合领域驱动设计(DDD)和函数式编程风格的C#项目，能够帮助开发者构建更加健壮和可维护的应用程序。