Go 中实现类型安全的错误捕获与值透传：无泛型时代的惯用方案_技术教程

在 go 1.18 之前，因缺乏用户自定义泛型函数，无法直接编写 `catcherror[t](val t, err error) t` 这类类型参数化函数；但可通过方法接收者+重载式类型方法或 `interface{}` + 显式断言实现类型安全（编译期检查仍保留于调用处），本文详解两种 idiomatic 实现方式及最佳实践。

Go 的类型系统强调显式性与编译期安全性。虽然 Go 1.18 引入了泛型，但若需兼容旧版本或追求更清晰的责任分离，基于接收者的方法链式设计是更符合 Go 惯用法（idiomatic）的解决方案。

✅ 推荐方案：错误收集器类型（ErrorCollector）

定义一个可扩展的错误收集器结构体，并为常用类型提供强类型方法：

type ErrorCollector []error

func (ec *ErrorCollector) Add(err error) {
    if err != nil {
        *ec = append(*ec, err)
    }
}

// 类型专用透传方法 —— 编译期确保类型匹配
func (ec *ErrorCollector) Int(v int, err error) int {
    ec.Add(err)
    return v
}

func (ec *ErrorCollector) Float64(v float64, err error) float64 {
    ec.Add(err)
    return v
}

func (ec *ErrorCollector) String(v string, err error) string {
    ec.Add(err)
    return v
}

// 支持自定义结构体（无需修改 collector，直接透传）
func (ec *ErrorCollector) Value[T any](v T, err error) T {
    ec.Add(err)
    return v
}

使用时自然、类型安全且无运行时 panic 风险：

var errors ErrorCollector

data := MyStruct{
    Age:              errors.Int(parseAndValidateAge("5")),           // ✅ int → int
    DistanceFromHome: errors.Float64(parseAndValidatePi("3.14")),     // ✅ float64 → float64
    Location:         errors.Value(parseAndValidateLocation("3.14,2.0")), // ✅ 自定义 struct
}

if len(errors) > 0 {
    log.Printf("Validation failed with %d errors: %+v", len(errors), errors)
    // 处理错误或返回 HTTP 400 等
}

? 注意：Value[T any] 是 Go 1.18+ 泛型方法，若需支持 Go
⚠️ 不推荐方案：interface{} + 类型断言

尽管可行，但违背 Go 的显式哲学：
func catchError(v interface{}, err error) interface{} {
    if err != nil {
        errors = append(errors, err)
    }
    return v
}
// 调用侧必须手动断言，丢失编译期类型保障：
Age:  catchError(parseAndValidateAge("5")).(int), // ❌ 运行时 panic 风险，不可读，难维护
此类写法绕过编译器检查，将类型错误推迟到运行时，且破坏 IDE 支持（跳转、自动补全失效），不符合 Go 的“明确优于隐含”原则。

✅ 最佳实践总结
优先使用接收者方法：errors.Int(...) 比全局函数更易测试、更易扩展、更符合 Go 风格；

避免裸 interface{} 透传：除非万不得已（如日志、序列化等通用层），否则应尽量保留具体类型；
Go 1.18+ 可升级为泛型工具函数（补充选项）：
func Catch[T any](v T, err error, errors *[]error) T {
    if err != nil {
        *errors = append(*errors, err)
    }
    return v
}
// 使用：Age: Catch(parseAndValidateAge("5"), &errors)
但注意：此函数需显式传入 *[]error，不如方法接收者简洁。
最终，以 ErrorCollector 为核心的状态感知工具类型，是兼顾类型安全、可读性、可维护性与 Go 惯用法的最优解。