当前位置：首页 > 文章列表 > Golang > Go教程 > Golang记录HTTP请求日志方法详解

Golang记录HTTP请求日志方法详解

2026-01-20 22:52:34 0浏览收藏

“纵有疾风来，人生不言弃”，这句话送给正在学习Golang的朋友们，也希望在阅读本文《Golang实现HTTP请求日志记录方法》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新Golang相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

使用中间件是Golang中记录HTTP请求日志的常见方式，通过封装http.Handler在请求前后记录方法、URL、IP、状态码和耗时等信息。1. 可创建自定义loggingMiddleware函数，利用responseWriter包装ResponseWriter以捕获状态码；2. 扩展日志内容可包括请求头、User-Agent等，读取请求体后需重置以便后续处理；3. 第三方库如gorilla/handlers提供LoggingHandler，支持类Apache日志格式输出；4. 生产环境建议将日志写入文件，可通过os.OpenFile打开日志文件并设置log.SetOutput或使用log.New指定输出目标。关键在于正确捕获响应状态码与请求生命周期，确保日志完整性。

如何在Golang中实现HTTP请求日志记录

在Golang中实现HTTP请求日志记录，最常见的方式是使用中间件（middleware）来拦截进入的HTTP请求和响应。通过封装http.Handler，可以在每次请求处理前后记录相关信息，如请求方法、URL、客户端IP、响应状态码、耗时等。

1. 使用自定义中间件记录请求日志

创建一个日志中间件函数，接收一个http.Handler并返回一个新的http.Handler，在其中添加日志逻辑：

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

        // 记录请求信息
        log.Printf(
            "started %s %s from %s",
            r.Method,
            r.URL.Path,
            r.RemoteAddr,
        )

        // 包装 ResponseWriter 以捕获状态码
        rw := &responseWriter{ResponseWriter: w, statusCode: http.StatusOK}
        next.ServeHTTP(rw, r)

        // 记录响应完成信息
        log.Printf(
            "completed %v %s in %v",
            rw.statusCode,
            http.StatusText(rw.statusCode),
            time.Since(start),
        )
    })
}

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

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

将中间件应用到你的路由处理器：

http.Handle("/hello", loggingMiddleware(http.HandlerFunc(helloHandler)))
log.Fatal(http.ListenAndServe(":8080", nil))

2. 记录更多上下文信息

你可以扩展日志内容，例如记录请求头、User-Agent、请求体大小等。注意：读取请求体需要谨慎，因为它是一次性读取的流。

log.Printf("method=%s path=%s remote=%s user-agent=%s",
    r.Method,
    r.URL.Path,
    r.RemoteAddr,
    r.Header.Get("User-Agent"),
)

若需记录请求体，可使用ioutil.ReadAll读取r.Body，但记得重新赋值r.Body以便后续处理器读取：

body, _ := io.ReadAll(r.Body)
log.Printf("body=%s", string(body))
r.Body = io.NopCloser(bytes.NewBuffer(body)) // 重置 Body

3. 使用第三方库简化日志记录

如果你希望快速集成，可以使用成熟的Go Web中间件库，比如chi或gorilla/handlers。

例如，使用gorilla/handlers的LoggingHandler：

import "github.com/gorilla/handlers"
import "os"

http.Handle("/hello", http.HandlerFunc(helloHandler))
log.Fatal(http.ListenAndServe(":8080",
    handlers.LoggingHandler(os.Stdout, http.DefaultServeMux),
))

这会自动输出类似Apache的日志格式，包含时间、方法、路径、状态码和耗时。

4. 日志输出到文件而非标准输出

生产环境中通常需要将日志写入文件。可以将日志输出重定向到文件：

logFile, err := os.OpenFile("access.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
    log.Fatal(err)
}
defer logFile.Close()

log.SetOutput(logFile) // 全局日志输出到文件

// 或仅中间件使用特定输出
logger := log.New(logFile, "", log.LstdFlags)
logger.Printf("started %s %s", r.Method, r.URL.Path)

基本上就这些。通过中间件方式，你可以灵活控制日志格式、字段和输出目标，同时保持代码解耦。不复杂但容易忽略的是包装ResponseWriter来获取状态码，这是实现完整请求生命周期日志的关键。

本篇关于《Golang记录HTTP请求日志方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！