Go语言中利用defer和recover优雅处理运行时错误与返回值

package main

import (
    "errors"
    "fmt"
)

// Report 结构体代表一个报告
type Report struct {
    Data map[string]float64
}

// getReport 尝试生成一个报告。如果函数内部发生 panic，
// defer 块会捕获它并将其转换为一个 error 返回。
func getReport(filename string) (rep *Report, err error) {
    // 初始化命名返回值 rep，确保即使没有 panic，它也是一个有效的指针
    rep = &Report{
        Data: make(map[string]float64),
    }

    // 使用 defer 配合 recover 来捕获可能的 panic
    defer func() {
        if r := recover(); r != nil {
            fmt.Printf("函数 getReport 捕获到 panic: %v\n", r)
            // 根据 panic 的具体类型设置 err
            switch x := r.(type) {
            case string:
                // 如果 panic 是一个字符串，将其封装成 error
                err = errors.New(fmt.Sprintf("运行时错误: %s", x))
            case error:
                // 如果 panic 已经是一个 error，直接使用
                err = x
            default:
                // 处理其他未知类型的 panic
                err = errors.New(fmt.Sprintf("未知运行时错误: %v", x))
            }
            // 如果发生 panic，说明 rep 可能处于不完整或无效状态，
            // 将其置为 nil，表示函数未能成功生成报告。
            rep = nil
        }
    }()

    // 模拟一个可能导致 panic 的操作。
    // 实际应用中，这可能是因为文件解析失败、配置错误、数组越界等。
    // 示例1: 模拟一个字符串类型的 panic (如原始问题所示)
    // panic("报告格式无法识别。")

    // 示例2: 模拟一个 error 类型的 panic (更专业的做法)
    panic(errors.New("文件解析失败：报告内容不符合预期格式"))

    // 正常情况下，这里会是获取报告数据的逻辑
    // rep.Data["Sales"] = 1234.56
    // rep.Data["Profit"] = 789.01
    // fmt.Println("报告数据处理完成。")
    // return rep, nil // 正常完成时，返回 rep 和 nil 错误
}

func main() {
    fmt.Println("--- 测试 error 类型 panic ---")
    report1, err1 := getReport("monthly_sales.txt")
    if err1 != nil {
        fmt.Printf("获取报告失败: %v\n", err1)
    } else {
        fmt.Printf("成功获取报告: %+v\n", report1)
    }

    fmt.Println("\n--- 测试 string 类型 panic ---")
    report2, err2 := func() (*Report, error) {
        var rep *Report
        var err error
        rep = &Report{
            Data: make(map[string]float64),
        }
        defer func() {
            if r := recover(); r != nil {
                fmt.Printf("内部函数捕获到 panic: %v\n", r)
                switch x := r.(type) {
                case string:
                    err = errors.New(fmt.Sprintf("运行时错误: %s", x))
                case error:
                    err = x
                default:
                    err = errors.New(fmt.Sprintf("未知运行时错误: %v", x))
                }
                rep = nil
            }
        }()
        panic("这是一个由字符串引发的 panic 示例") // 模拟字符串 panic
        return rep, err
    }()

    if err2 != nil {
        fmt.Printf("获取报告失败 (字符串 panic): %v\n", err2)
    } else {
        fmt.Printf("成功获取报告 (字符串 panic): %+v\n", report2)
    }
}

--- 测试 error 类型 panic ---
函数 getReport 捕获到 panic: 文件解析失败：报告内容不符合预期格式
获取报告失败: 文件解析失败：报告内容不符合预期格式

--- 测试 string 类型 panic ---
内部函数捕获到 panic: 这是一个由字符串引发的 panic 示例
获取报告失败 (字符串 panic): 运行时错误: 这是一个由字符串引发的 panic 示例