1. 错误处理概述

1.1 Go 语言错误处理哲学

Go 语言在错误处理上采用了与主流语言截然不同的设计哲学：显式错误检查。函数调用后，调用方必须主动检查返回的错误值，编译器不会自动抛出或传播异常。这种设计将错误视为普通值，而非控制流机制。

Go 的错误处理建立在三个基础概念之上：

• error 接口：内置的 error 类型是一个仅包含 Error() string 方法的接口，任何实现了该接口的类型都可作为错误。
• 多返回值：函数通常将 error 作为最后一个返回值，调用方通过 if err != nil 模式检查。
• 延迟处理（defer）：用于资源清理，确保即使发生错误也能正确释放资源。

// 典型的 Go 错误处理模式
func ReadReport(path string) (*Report, error) {
    f, err := os.Open(path)
    if err != nil {
        return nil, fmt.Errorf("打开报表文件失败: %w", err)
    }
    defer f.Close()

    data, err := io.ReadAll(f)
    if err != nil {
        return nil, fmt.Errorf("读取报表数据失败: %w", err)
    }

    report, err := ParseReport(data)
    if err != nil {
        return nil, fmt.Errorf("解析报表失败: %w", err)
    }

    return report, nil
}

1.2 错误与异常的区别

理解错误（Error）与异常（Exception）的区别，是掌握 Go 错误处理哲学的关键。下表从多个维度对比两者的差异：

Go 语言也提供了 panic 和 recover 机制，但设计初衷并非替代错误处理：

• panic：表示程序无法继续运行的严重错误，如索引越界、断言失败。
• recover：仅在 defer 函数中有效，用于捕获 panic 并恢复执行，常用于 goroutine 的顶级保护。

// panic 的正确使用场景：不可恢复的编程错误
func MustParseReport(data []byte) *Report {
    report, err := ParseReport(data)
    if err != nil {
        panic(fmt.Sprintf("解析报表失败: %v", err))
    }
    return report
}

// recover 用于 goroutine 保护
func SafeGenerateReport(reportID string) {
    defer func() {
        if r := recover(); r != nil {
            log.Printf("报表生成 goroutine 崩溃: %v", r)
        }
    }()
    GenerateReport(reportID)
}

1.3 错误处理在报表系统中的重要性

报表系统对数据准确性、完整性和可追溯性有极高要求，错误处理直接决定系统的可靠性。以下是错误处理在报表系统中的关键作用：

在报表系统中，错误处理不当会导致以下严重后果：

• 数据不一致：部分写入的报表文件导致后续分析基于不完整数据。
• 排查困难：错误信息模糊，无法定位是数据源问题、计算逻辑问题还是输出问题。
• 级联故障：一个报表生成失败导致整个调度链路阻塞，影响下游依赖。
• 用户信任下降：频繁出现无意义或重复的错误提示，降低系统可信度。

1.4 错误码断言：从模糊到精确

传统的 if err != nil 模式只能判断“是否发生错误”，无法区分“发生了什么类型的错误”。在报表系统中，我们需要根据错误类型采取不同的恢复策略：