首页 > Golang > Go教程

GolangHTTP接口日志记录教程

时间：2025-11-22 20:33:46 289浏览收藏

本文详细介绍了如何在 Golang 中通过中间件记录 HTTP 接口的请求日志，并提供了一些实用的日志分析技巧。针对 Golang HTTP 接口的调试、监控和安全审计需求，文章首先展示了如何使用自定义 `responseWriter` 捕获状态码，并在中间件中记录关键信息，如 IP、方法、URI、状态码、请求耗时和 User-Agent。随后，文章建议采用诸如 zap 等结构化日志库，将日志输出为 JSON 格式，以便于后续的自动化分析。最后，文章还分享了利用 grep、awk、jq 等工具进行高频接口统计、错误请求排查、慢响应分析以及 IP 访问量统计的实用技巧，旨在帮助开发者构建轻量且高效的 Golang 服务日志体系。

答案：通过中间件记录HTTP请求日志并使用结构化日志库如zap输出JSON格式日志，便于后续分析。1. 使用自定义responseWriter捕获状态码；2. 在中间件中记录IP、方法、URI、状态码、耗时和User-Agent；3. 接入zap等库实现结构化日志；4. 利用grep、awk、jq等工具进行高频接口、错误请求、慢响应和IP访问量分析。

Golang HTTP接口日志记录与分析示例

在 Golang 中开发 HTTP 接口时，记录和分析请求日志是调试、监控和安全审计的重要手段。一个良好的日志系统能帮助你快速定位问题、了解用户行为，并为性能优化提供数据支持。下面通过一个简单但实用的示例，展示如何实现 HTTP 接口的日志记录与基本分析。

使用中间件记录 HTTP 请求日志

Go 的 http.Handler 支持中间件模式，我们可以通过封装 handler 来实现统一的日志记录。

以下是一个基础的日志中间件：

func loggingMiddleware(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()

        // 记录原始信息
        ip := r.RemoteAddr
        method := r.Method
        uri := r.URL.RequestURI()
        userAgent := r.Header.Get("User-Agent")

        // 包装 ResponseWriter 以获取状态码
        rw := &responseWriter{ResponseWriter: w, statusCode: http.StatusOK}

        // 调用实际处理函数
        next.ServeHTTP(rw, r)

        // 日志输出
        log.Printf(
            "ip=%s method=%s uri=%s status=%d duration=%v user_agent=%q",
            ip, method, uri, rw.statusCode, time.Since(start), userAgent,
        )
    })
}

// 自定义 ResponseWriter 获取状态码
type responseWriter struct {
    http.ResponseWriter
    statusCode int
}

func (rw *responseWriter) WriteHeader(code int) {
    rw.statusCode = code
    rw.ResponseWriter.WriteHeader(code)
}

接入日志中间件到 HTTP 服务

将上述中间件应用到你的路由中，可以对所有请求进行统一记录。

func main() {
    mux := http.NewServeMux()

    mux.HandleFunc("/api/hello", func(w http.ResponseWriter, r *http.Request) {
        w.Header().Set("Content-Type", "application/json")
        w.WriteHeader(http.StatusOK)
        json.NewEncoder(w).Encode(map[string]string{
            "message": "Hello, World!",
        })
    })

    // 使用中间件包装 mux
    loggedMux := loggingMiddleware(mux)

    log.Println("Server starting on :8080...")
    http.ListenAndServe(":8080", loggedMux)
}

访问 /api/hello 后，控制台会输出类似：

2025/04/05 10:00:00 ip=127.0.0.1:56789 method=GET uri=/api/hello status=200 duration=123.45µs user_agent="curl/7.68.0"

结构化日志与分析建议

默认的 log 包输出的是文本日志，不利于后续分析。推荐使用 zap 或 logrus 等支持结构化日志的库。

例如使用 zap：

import "go.uber.org/zap"

var logger *zap.Logger

func init() {
    var err error
    logger, err = zap.NewProduction()
    if err != nil {
        panic(err)
    }
}

// 在中间件中替换 log.Printf 为：
logger.Info("http_request",
    zap.String("ip", ip),
    zap.String("method", method),
    zap.String("uri", uri),
    zap.Int("status", rw.statusCode),
    zap.Duration("duration", time.Since(start)),
    zap.String("user_agent", userAgent),
)

输出将是 JSON 格式，便于被 ELK、Loki 等系统采集和查询。

简单日志分析技巧

有了结构化日志后，你可以进行一些基础分析：

统计高频接口：grep '"uri":"/api/' logs.json | awk '{print $8}' | sort | uniq -c | sort -nr
查看错误请求：grep '"status":5' logs.json
分析响应慢的请求：jq 'select(.duration > 1)' logs.json
按 IP 统计访问量：grep '"ip"' logs.json | awk '{print $6}' | sort | uniq -c

基本上就这些。通过中间件记录日志，再配合结构化输出，就能为 Go 服务构建一个轻量但有效的日志体系。不复杂但容易忽略。

终于介绍完啦！小伙伴们，这篇关于《GolangHTTP接口日志记录教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！

日志分析中间件结构化日志 GolangHTTP HTTP请求日志