使用 标准库 log 包记录错误信息,可通过 log.Println 或 log.printf 输出,适用于简单场景,便于快速实现基础日志功能。

在 go 语言开发中,日志记录和错误处理是保障程序可维护性和稳定性的关键环节。合理地记录错误信息,有助于快速定位问题、分析系统行为。以下是几种常见的 golang 日志记录中处理错误信息的方法与实践建议。
使用 标准库 log 包记录错误
Go 的 log 包是最基础的日志 工具,适合简单的错误输出场景。
- 通过 log.Println 或log.Printf直接输出错误信息
示例代码:
if err != nil {log.Printf(" 文件读取失败: %v", err) }
注意:标准 log 不支持分级(如 debug、warn),也不便于结构化输出,适合小型项目或调试阶段。
立即学习“go 语言免费学习笔记(深入)”;
结合 errors 包增强错误上下文
原生 error 信息通常较简略,可通过 errors.Wrap 或类似方式添加上下文。
- github.com/pkg/errors 包装错误
示例:
import "github.com/pkg/errors" if err != nil {log.Printf(" 数据库连接失败: %+v", errors.WithMessage(err, " 初始化连接时出错 ")) }
%+v 可打印完整的堆栈跟踪,帮助开发者快速定位错误源头。
使用结构化日志提升可检索性
对于生产环境,推荐使用结构化日志库,如zap、logrus。
zap 示例:
logger, _ := zap.NewProduction() defer logger.Sync() if err != nil {logger.Error(" 请求处理失败 ", zap.String("url", req.URL.Path), zap.Error(err), ) }
结构化字段让排查更高效,尤其在高并发服务中尤为重要。
避免敏感信息泄露
记录错误时需警惕日志安全问题。
例如:
if err != nil {log.Printf(" 用户登录失败,用户 ID: %s", userID) // 避免打印密码或完整请求体 }
基本上就这些。选择合适的日志方案,结合清晰的错误包装和安全意识,能让 Go 程序更健壮、易维护。关键是根据项目规模和部署环境,平衡简洁性与功能性。