Golang日志中如何进行错误分类

在Go语言开发中，日志记录几乎是每个项目都要面对的基础环节。说到错误分类，怎么在日志里把不同类型的错误区分清楚，方便后续排查和监控？这其实是个很实际的问题。标准库log虽然简单好用，但要想给错误打上清晰的“标签”，就得自己动点手脚。

来看一个最直接的例子：我们可以先定义一个自定义的错误码类型，然后在日志输出时把错误码和具体信息一起打印出来。这样，日志里每一行都包含了错误类型编号，一眼就能看出是文件找不到还是输入不合法，比光扔个“error”字符串靠谱多了。

package main

import (
	"log"
	"os"
)

type ErrorCode int

const (
	ErrCodeNone ErrorCode = iota
	ErrCodeFileNotFound
	ErrCodeInvalidInput
)

func main() {
	err := os.Open("nonexistent.txt")
	if err != nil {
		log.Printf("Error %d: %v", ErrCodeFileNotFound, err)
		return
	}
	// 其他业务逻辑
}

这段代码里，ErrorCode类型配合iota自动枚举，ErrCodeFileNotFound、ErrCodeInvalidInput分别对应不同的错误场景。当os.Open失败时，日志就会输出类似“Error 1: open nonexistent.txt: no such file or directory”的信息。虽然简单，但已经具备了基础分类能力。

不过，如果项目规模稍微大一点，往往希望日志更结构化一些，比如能直接按字段查询、过滤。这时候就该上第三方日志库了，像logrus或zap都提供了结构化日志功能，能把错误码、错误信息、调用链等作为独立字段输出，而不是拼在一段字符串里。

以logrus为例，先设置JSONFormatter，然后通过WithFields方法把错误码和错误对象作为字段添加进去——WithFields返回一个带上下文的Entry，再调用Error方法输出。这样一来，日志会以JSON格式呈现，每个字段清晰可读，监控系统解析起来也方便。

package main

import (
	"github.com/sirupsen/logrus"
	"os"
)

type ErrorCode int

const (
	ErrCodeNone ErrorCode = iota
	ErrCodeFileNotFound
	ErrCodeInvalidInput
)

func main() {
	logrus.SetFormatter(&logrus.JSONFormatter{})
	err := os.Open("nonexistent.txt")
	if err != nil {
		logrus.WithFields(logrus.Fields{
			"error_code": ErrCodeFileNotFound,
			"error":      err,
		}).Error("Failed to open file")
		return
	}
	// 其他业务逻辑
}

两种方式各有适用场景：标准库零依赖、上手快，适合小工具或快速原型；结构化日志库则更适合需要集中日志管理、实时告警的线上服务。实际项目里，很多人会把错误码和错误类型定义在公共包中，再结合上下文信息统一输出，这样既保持了代码整洁，也方便后续做错误聚合分析。

说到底，错误分类的核心不在于用什么库，而在于你愿不愿意为每一类错误赋予一个明确的“身份标识”。哪怕只是一个简单的数字代码，配合一致的日志格式，也能让后续的排查工作轻松不少。