Go语言中优雅错误处理的正确方法详解

package service

import (
	"github.com/pkg/errors"
)

// mockGetFromCache 模拟从缓存获取数据
func mockGetFromCache(phone string) error {
	return nil
}

// VerifySmsCodeBad 典型的反模式：使用字符串返回业务错误提示
// 返回值1：业务错误提示信息（如果有的话）
// 返回值2：系统级异常
func VerifySmsCodeBad(phone, code string) (string, error) {
	if code == "" {
		// ❌ 用字符串代表业务异常
		return "验证码参数不完整", nil
	}

	// 模拟从缓存获取验证码并发生反序列化异常
	err := mockGetFromCache(phone)
	if err != nil {
		// 系统级异常，正常返回 error，这里使用 errors.Wrap 包装原始错误
		return "", errors.Wrap(err, "验证码缓存数据反序列化异常")
	}

	// 模拟验证码不匹配
	if code != "123456" {
		return "验证码已过期或不存在", nil
	}

	// ✅ 校验通过
	return "", nil
}

package service

import (
	"github.com/pkg/errors"
)

// 预定义业务错误（Sentinel Errors），通常以 Err 开头
var (
	ErrSmsCodeIncomplete = errors.New("验证码参数不完整")
	ErrSmsCodeExpired    = errors.New("验证码已过期或不存在")
)

// VerifySmsCodeGood 推荐做法：统一使用 error 接口传递所有异常
func VerifySmsCodeGood(phone, code string) error {
	if code == "" {
		// ✅ 直接返回预定义的 error 变量
		return ErrSmsCodeIncomplete
	}

	err := mockGetFromCache(phone)
	if err != nil {
		// 包装系统底层错误，追加堆栈信息
		return errors.Wrap(err, "验证码缓存数据反序列化异常")
	}

	if code != "123456" {
		return ErrSmsCodeExpired
	}

	// ✅ 校验通过，统一返回 nil
	return nil
}

package handler

import (
	"errors"
	"fmt"
	"your_project/service" // 假设引入了上面的 service 包
)

func HandleLogin(phone, code string) {
	err := service.VerifySmsCodeGood(phone, code)
	if err != nil {
		// 使用 errors.Is 准确判断是否是特定的业务错误
		if errors.Is(err, service.ErrSmsCodeIncomplete) {
			fmt.Println("前端提示：请填写完整的验证码！")
			return
		}
		if errors.Is(err, service.ErrSmsCodeExpired) {
			fmt.Println("前端提示：验证码无效，请重新获取。")
			return
		}
		
		// 处理未知的系统级错误
		fmt.Printf("系统内部异常: %+v\n", err)
		return
	}
	
	fmt.Println("登录成功！")
}

package service

import (
	"errors"
	"fmt"
)

// SmsRetryError 自定义错误类型，用于携带额外业务数据
type SmsRetryError struct {
	RemainTimes int
	Msg         string
}

// Error 实现 error 接口
func (e *SmsRetryError) Error() string {
	return fmt.Sprintf("%s, 您还有%d次重试机会", e.Msg, e.RemainTimes)
}

func VerifyWithRetry() error {
	// 返回携带动态数据的自定义错误
	return &SmsRetryError{RemainTimes: 3, Msg: "验证码错误"}
}

func HandleRetry() {
	err := VerifyWithRetry()
	if err != nil {
		var retryErr *SmsRetryError
		// 使用 errors.As 将 err 转换为具体的 SmsRetryError 类型指针
		if errors.As(err, &retryErr) {
			fmt.Printf("捕获到业务异常：还可以重试 %d 次\n", retryErr.RemainTimes)
			return
		}
	}
}

package service

import (
	"errors"
	"fmt"
)

var ErrSmsLimit = errors.New("触发限流")

func CheckLimit() error {
	userID := 1024
	// 使用 %w 包装错误，既保留了底层的 ErrSmsLimit，又加入了动态的 userID 信息
	return fmt.Errorf("user %d: %w", userID, ErrSmsLimit)
}

func HandleLimit() {
	err := CheckLimit()
	// 调用方依然可以使用 errors.Is(err, ErrSmsLimit) 匹配成功
	if errors.Is(err, ErrSmsLimit) {
		fmt.Println("检测到限流错误！")
	}
}