Golang mgo 错误处理深度指南

package main

import (
    "errors"
    "fmt"
    "log"
)

// 模拟 mgo-like 错误类型
// 在实际应用中，mgo 会返回具体的 error 类型，例如 mgo.ErrNotFound
var (
    ErrNotFound      = errors.New("document not found") // 模拟 mgo.ErrNotFound
    ErrQueryFailed   = errors.New("query execution failed")
    ErrNetworkIssue  = errors.New("network connection error")
    ErrTimeout       = errors.New("operation timed out")
)

// 模拟一个 mgo 操作，它可能返回各种错误
func getDocument(id string) (string, error) {
    // 实际 mgo 操作会在这里进行，并返回其自身的 error 类型
    switch id {
    case "found":
        return "Document Content for ID: found", nil
    case "not_found":
        return "", ErrNotFound // 模拟文档未找到
    case "network_error":
        return "", ErrNetworkIssue // 模拟网络连接问题
    case "timeout_error":
        return "", ErrTimeout // 模拟操作超时
    case "other_query_error":
        return "", ErrQueryFailed // 模拟其他查询执行错误
    default:
        // 模拟一个未预料的底层错误，例如 mgo 内部解析错误
        return "", fmt.Errorf("unexpected internal mgo error for ID: %s", id)
    }
}

func main() {
    idsToTest := []string{"found", "not_found", "network_error", "timeout_error", "other_query_error", "unknown_id"}

    for _, id := range idsToTest {
        fmt.Printf("\n--- 尝试获取文档 ID: %s ---\n", id)
        data, err := getDocument(id) // 假设这是调用 mgo 的函数

        if err != nil {
            // 1. 处理已知错误 (例如，文档未找到)
            if errors.Is(err, ErrNotFound) { // 使用 errors.Is 兼容包装的错误
                fmt.Printf("  错误类型: 数据未找到。ID: %s\n", id)
                // 业务逻辑：例如，返回 HTTP 404 Not Found
            } else if errors.Is(err, ErrNetworkIssue) || errors.Is(err, ErrTimeout) {
                // 2. 处理预期的操作性错误 (例如，网络问题、超时)
                // 这些错误不应 panic。记录详细日志，可能触发告警，向上层传递
                // 上层通常会返回 HTTP 500 Internal Server Error
                fmt.Printf("  错误类型: 数据库连接或网络问题。请检查服务状态。错误详情: %v\n", err)
                // log.Printf("MongoDB operational error for ID %s: %v", id, err)
            } else {
                // 3. 处理所有其他未知或未明确分类的错误
                // 同样不应 panic。记录详细日志，向上层传递，返回 HTTP 500
                fmt.Printf("  错误类型: 发生未预期错误。错误详情: %v\n", err)
                // log.Printf("Unexpected mgo error for ID %s: %v", id, err)
            }
            // 在实际应用中，这里可能需要清理操作，例如关闭游标或文件
        } else {
            fmt.Printf("  成功获取数据: %s\n", data)
            // 业务逻辑：例如，返回 HTTP 200 OK 和数据
        }
    }
}