如何让Google Cloud HTTP函数自动记录错误响应消息？

核心原因 #

你使用的是第二世代Google Cloud HTTP Functions（日志中显示cloud_run_revision，说明底层基于Cloud Run），平台自动生成的请求日志（run.googleapis.com/requests）默认仅记录请求元数据（状态码、响应大小等），不会捕获http.Error返回的响应体内容。

除手动记录外的自动实现方式 #

可以通过自定义ResponseWriter包装器捕获响应内容，在响应完成后自动记录错误日志，无需每次手动调用日志API：

示例代码 #

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

// 自定义ResponseWriter，用于捕获状态码和响应体
type loggingResponseWriter struct {
    http.ResponseWriter
    statusCode int
    body       []byte
}

func newLoggingResponseWriter(w http.ResponseWriter) *loggingResponseWriter {
    return &loggingResponseWriter{w, http.StatusOK, nil}
}

func (lrw *loggingResponseWriter) Write(b []byte) (int, error) {
    lrw.body = append(lrw.body, b...)
    return lrw.ResponseWriter.Write(b)
}

func (lrw *loggingResponseWriter) WriteHeader(code int) {
    lrw.statusCode = code
    lrw.ResponseWriter.WriteHeader(code)
}

func Scrape(w http.ResponseWriter, r *http.Request) {
    // 包装原始ResponseWriter
    lrw := newLoggingResponseWriter(w)
    
    err := validateRequestData(r)
    if err != nil {
        http.Error(lrw, "my error message", http.StatusBadRequest)
        // 自动记录4xx/5xx错误日志
        if lrw.statusCode >= http.StatusBadRequest {
            slog.Error(
                "HTTP request failed",
                "status_code", lrw.statusCode,
                "error_message", string(lrw.body),
                "request_path", r.URL.Path,
                "request_method", r.Method,
            )
        }
        return
    }

    // 正常处理逻辑
    lrw.WriteHeader(http.StatusOK)
    lrw.Write([]byte("success"))
}

这种方式只需在函数入口包装一次，就能自动捕获所有错误响应并记录到Cloud Logging中，日志会和请求元数据通过trace ID关联。

关于超时日志的textPayload #

平台触发的超时日志（如函数执行超时）的textPayload是平台自动生成的固定内容，无法通过http.Error传递自定义信息。原因是超时发生时，函数进程已被平台终止，http.Error根本无法执行。如果需要在超时场景下记录自定义信息，只能在函数内部设置超时预警逻辑（比如用定时器监控执行时间），提前手动记录日志，但无法修改平台生成的超时日志内容。

内容的提问来源于stack exchange，提问作者Clash