Golang记录API请求日志的方法

在Go语言中，记录API请求是一项常见需求，标准库 log 即可满足基础场景，当然第三方库如 logrus、zap 提供了更丰富的功能。本文先以标准库为例，演示最核心的日志记录方法。

首先搭建一个最简单的HTTP服务器：

package main

import (
    "fmt"
    "log"
    "net/http"
)

func main() {
    http.HandleFunc("/", handleRequest)
    log.Fatal(http.ListenAndServe(":8080", nil))
}

func handleRequest(w http.ResponseWriter, r *http.Request) {
    logRequest(r)
    fmt.Fprintf(w, "Hello, World!")
}

接着在 handleRequest 中调用 logRequest 来记录请求的详细信息：

func logRequest(r *http.Request) {
    log.Printf("Request: %s %s %s", r.RemoteAddr, r.Method, r.URL)
    log.Printf("Headers: %v", r.Header)
    log.Printf("Body: %s", r.Body)
}

上述示例会打印每个请求的IP、HTTP方法、URL、请求头以及请求体。但需要注意一个限制：r.Body 只能被读取一次，读取后即被消耗。为了让后续处理逻辑仍能访问请求体，需要自定义一个 io.ReadCloser 来缓存 Body 内容。

package main

import (
    "bytes"
    "fmt"
    "io/ioutil"
    "log"
    "net/http"
)

func main() {
    http.HandleFunc("/", handleRequest)
    log.Fatal(http.ListenAndServe(":8080", nil))
}

func handleRequest(w http.ResponseWriter, r *http.Request) {
    logRequest(r)
    fmt.Fprintf(w, "Hello, World!")
}

func logRequest(r *http.Request) {
    log.Printf("Request: %s %s %s", r.RemoteAddr, r.Method, r.URL)
    log.Printf("Headers: %v", r.Header)

    bodyBytes, err := ioutil.ReadAll(r.Body)
    if err != nil {
        log.Printf("Error reading body: %v", err)
        return
    }
    defer r.Body.Close()

    log.Printf("Body: %s", bodyBytes)

    // 恢复请求体内容，允许后续处理器再次读取
    r.Body = ioutil.NopCloser(bytes.NewBuffer(bodyBytes))
}

如此，使用 Go 标准库 log 即可稳定地记录 API 请求。如果日后标准库的功能无法满足需求——例如需要日志分级、结构化输出——再引入 logrus 或 zap 等第三方库也不迟。