当前位置：首页 > news >正文

GO 日志的规范使用

news 2026/7/4 3:00:57

平时不太说废话，今天主要讲讲编程素质类的内容大家有兴趣的酌情阅读

GO语言日志的规范使用

在任何服务端的语言项目中，日志是至关重要的组成部分，它能够记录系统的运行状态、错误信息和关键事件，对于问题排查、性能优化以及系统监控都具有不可替代的作用。以下是一些关于如何规范使用GO语言日志的建议，以及相应的实际示例：

日志等级划分：日志等级通常包括 Debug、Info、Warn、Error、DPanic 和 Fatal 等级别。不同等级的日志用于记录不同重要程度的信息。

Debug：用于记录详细的调试信息，仅在开发和测试阶段启用。
Info：用于记录正常运行状态的信息。
Warn：用于记录警告，表明可能发生了某些问题，但程序仍能正常运行。
Error：用于记录错误信息，表明发生了可恢复的错误。
DPanic：用于记录非致命性的错误，但会导致程序崩溃。
Fatal：用于记录致命性错误，会导致程序终止运行。

何时打印何种等级的日志：根据日志等级的定义，应在以下情况下使用相应的日志等级：

Debug：在需要详细调试信息时，例如在开发和测试阶段。
Info：在程序正常运行时，记录关键信息和状态。
Warn：在发现一些可能的问题，但程序仍可继续运行时。
Error：在发生可恢复的错误时，表明程序出现了问题，但还能继续运行。
DPanic 和 Fatal：通常用于记录致命性错误，需要立即停止程序运行。

打印格式与时间戳：日志格式应包括时间、日志级别、文件名、行号、消息等信息。时区时间是一个重要的考虑因素，确保日志记录的时间是可读的。
日志分割与存储：日志应该以天为单位切换文件，并设置文件的最大上限以避免文件过大。当每天的文件大小超过阈值时，需要将当天的文件按序编号。
实际示例：
这里我们采用之前基于zap封装的通用日志模块集中处理Go 统一日志处理中的通用模块

Web服务示例：

packagemain import("github.com/gin-gonic/gin""your_project/common")funcmain(){common.Info("Web service started") router:=gin.Default()// Handlersrouter.GET("/",func(c*gin.Context){common.Debug("Handling root endpoint")c.JSON(200,gin.H{"message":"Hello, World!"})})// ...// Start the servererr:=router.Run(":8080")iferr!=nil{common.Error("Failed to start server",err)}}

GO Micro 示例：

packagemain import("context""github.com/micro/go-micro""github.com/micro/go-micro/service/grpc""your_project/common")funcmain(){// Create a new serviceservice:=grpc.NewService(micro.Name("example"),)// ...// Register the serviceiferr:=service.Run();err!=nil{common.Fatal("Service registration failed",err)}}

读取请求示例（Web服务）：

packagemain import("github.com/gin-gonic/gin""your_project/common")funcgetUserHandler(c*gin.Context){// Reading parameters from the requestuserID:=c.Param("id")// Logging the received requestcommon.Info("Received request to fetch user with ID:",userID)// Perform necessary operations, e.g., fetch user from the database// Logging the completion of the requestcommon.Info("Request processed successfully") c.JSON(200,gin.H{"message":"User fetched successfully"})}funcmain(){router:=gin.Default() router.GET("/user/:id",getUserHandler)// Start the servererr:=router.Run(":8080")iferr!=nil{common.Fatal("Failed to start server",err)}}

被动接受请求示例（GO Micro）：

packagemain import("context""github.com/micro/go-micro""github.com/micro/go-micro/service/grpc""your_project/common")// UserServiceHandler implements the UserService interfacetypeUserServiceHandlerstruct{}func(u*UserServiceHandler)GetUser(ctx context.Context,req*UserRequest,res*UserResponse)error{// Log the received requestcommon.Info("Received GetUser request for user ID:",req.UserId)// Perform necessary operations, e.g., fetch user from the database// Log the completion of the requestcommon.Info("GetUser request processed successfully")returnnil}funcmain(){// Create a new serviceservice:=grpc.NewService(micro.Name("example"),)// Register the service handlerservice.Init()UserService:=micro.NewService()UserService.Server().Handle(UserService.Server().NewHandler(&UserServiceHandler{}),)// ...// Run the serviceiferr:=service.Run();err!=nil{common.Fatal("Service registration failed",err)}}

读取消息中间件（如 Kafka）示例：

packagemain import("context""github.com/segmentio/kafka-go""your_project/common")funcmain(){r:=kafka.NewReader(kafka.ReaderConfig{// ...})for{m,err:=r.ReadMessage(context.Background())iferr!=nil{common.Error("Error reading message from Kafka",err)continue}// Process the messagecommon.Info("Message received:",string(m.Value))}}

Redis 缓存使用示例：

packagemain import("context""github.com/go-redis/redis/v8""your_project/common")funcmain(){// ...// Example: Fetch data from Redis cachekey:="example_key"val,err:=redisClient.Get(context.Background(),key).Result()iferr==redis.Nil{// Cache misscommon.Warn("Cache miss for key:",key)}elseiferr!=nil{// Error accessing Redis cachecommon.Error("Error accessing Redis cache:",err)}else{// Data retrieved successfully from cachecommon.Info("Data retrieved from cache:",val)}}