在Golang项目开发中，仅记录错误文本往往不足以支撑问题排查，我们需要结合error机制和日志功能，记录包含错误详情、调用链信息的完整日志，才能快速定位问题根源。
基础错误记录的问题
很多初学者直接使用标准库的log包记录错误，这种方式只能输出错误文本，无法获取错误发生的调用位置，示例代码如下：
package main
import (
"errors"
"log"
)
func doSomething() error {
return errors.New("操作失败")
}
func main() {
err := doSomething()
if err != nil {
log.Printf("发生错误: %v", err)
}
}
上述代码输出的日志只有错误文本，没有调用栈信息，当项目逻辑复杂时很难定位错误来源。
自定义错误类型封装调用信息
我们可以通过自定义错误类型，在错误生成时自动捕获调用栈、文件名、行号等信息，首先定义错误结构体：
package main
import (
"fmt"
"runtime"
"strings"
)
// 自定义错误类型，包含错误信息和调用栈
type AppError struct {
Msg string // 错误描述
File string // 错误发生的文件名
Line int // 错误发生的行号
FuncName string // 错误发生的函数名
Stack string // 完整调用栈
OriginErr error // 原始错误
}
// 实现error接口的Error方法
func (e *AppError) Error() string {
return fmt.Sprintf("%s (发生位置: %s:%d, 函数: %s)", e.Msg, e.File, e.Line, e.FuncName)
}
// 创建自定义错误的函数
func NewAppError(msg string, originErr error) *AppError {
// 获取调用栈信息，跳过2层调用（NewAppError本身和调用NewAppError的函数）
pc, file, line, ok := runtime.Caller(2)
funcName := ""
if ok {
// 获取函数名
funcName = runtime.FuncForPC(pc).Name()
// 简化函数名，去掉包路径前缀
if idx := strings.LastIndex(funcName, "/"); idx != -1 {
funcName = funcName[idx+1:]
}
}
// 捕获完整调用栈
buf := make([]byte, 4096)
n := runtime.Stack(buf, false)
stack := string(buf[:n])
return &AppError{
Msg: msg,
File: file,
Line: line,
FuncName: funcName,
Stack: stack,
OriginErr: originErr,
}
}
结合日志输出完整错误信息
接下来我们可以在业务逻辑中使用自定义错误，并结合日志输出完整信息，示例代码如下：
package main
import (
"log"
"os"
)
func initLogger() *log.Logger {
// 初始化日志实例，输出到标准输出，包含日期和时间
return log.New(os.Stdout, "", log.LstdFlags|log.Lshortfile)
}
func businessLogic() error {
// 模拟业务操作失败
originErr := errors.New("数据库连接超时")
// 创建自定义错误
return NewAppError("业务处理失败", originErr)
}
func main() {
logger := initLogger()
err := businessLogic()
if err != nil {
// 类型断言获取自定义错误
if appErr, ok := err.(*AppError); ok {
logger.Printf("详细错误信息: %v", appErr)
logger.Printf("原始错误: %v", appErr.OriginErr)
logger.Printf("完整调用栈:n%s", appErr.Stack)
} else {
logger.Printf("普通错误: %v", err)
}
}
}
运行上述代码后，日志会输出错误描述、发生位置、原始错误以及完整调用栈，方便我们快速定位问题。
错误链传递与信息保留
在实际开发中，错误往往会在多层函数之间传递，我们需要确保每一层传递的错误都保留完整的调用信息，修改businessLogic函数模拟多层调用场景：
package main
import "errors"
func daoLayer() error {
// 数据层错误
return errors.New("查询用户数据失败")
}
func serviceLayer() error {
err := daoLayer()
if err != nil {
// 包装错误，保留原始错误和当前调用信息
return NewAppError("服务层处理失败", err)
}
return nil
}
func businessLogic() error {
err := serviceLayer()
if err != nil {
// 继续包装错误
return NewAppError("业务层处理失败", err)
}
return nil
}
这样无论错误传递到哪一层，我们都可以通过自定义错误结构获取到完整的错误链和每一层的调用信息，排查问题时可以清晰看到错误从数据层到业务层的传递路径。
总结
通过自定义错误类型结合runtime包的调用栈捕获能力，我们可以在Golang中实现包含详细错误信息和调用链的错误日志记录。这种方式比单纯记录错误文本更高效，能够大幅降低问题排查的时间成本。开发者可以根据项目需求调整错误结构体的字段，比如增加错误级别、错误码等字段，让错误日志更贴合项目的实际需求。