在goframe框架中,获取和设置自定义http请求头需要分别处理服务端接收请求和客户端发起请求两个场景。服务端通过 request.header() 方法读取请求头,并通过 response.header().set() 方法写入响应头;客户端则使用 ghttp.client.setheader() 配置发送时的请求头。这些操作均基于标准的 net/http header 映射结构,支持字符串类型的键值对。

服务端如何读取客户端传入的自定义请求头
服务端直接调用 request.Header() 即可获取包含所有自定义头的映射表,通过指定键名(如 X-Request-Id)提取对应值。若该头不存在,返回空字符串,不会引发错误。

package main
import (
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/net/ghttp"
)
func main() {
s := g.Server()
s.Group("/", func(group *ghttp.RouterGroup) {
group.Middleware(ghttp.MiddlewareHandlerResponse)
group.GET("/check", func(r *ghttp.Request) {
// 获取自定义请求头 X-Custom-Value
customVal := r.Header.Get("X-Custom-Value")
if customVal == "" {
customVal = "default_value"
}
r.Response.WriteJson(g.Map{
"received": customVal,
})
})
})
s.Run()
}
预期结果:当客户端发送带有 X-Custom-Value: test_data 的请求时,接口返回 {"received":"test_data"};若无此头,则返回 {"received":"default_value"}。
服务端如何向客户端写入自定义响应头
服务端在中间件或路由处理器中,通过 r.Response.Header().Set() 设置自定义响应头,例如 X-Server-Time。该操作会在响应体发送前将头信息加入 HTTP 响应帧中,客户端可通过标准 HTTP 解析器读取。

package main
import (
"time"
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/net/ghttp"
)
func main() {
s := g.Server()
s.Group("/", func(group *ghttp.RouterGroup) {
group.Middleware(ghttp.MiddlewareHandlerResponse)
group.GET("/info", func(r *ghttp.Request) {
// 设置自定义响应头
r.Response.Header().Set("X-Server-Time", time.Now().Format(time.RFC3339))
r.Response.Header().Set("X-App-Version", "v1.0.0")
r.Response.WriteJson(g.Map{
"status": "ok",
})
})
})
s.Run()
}
预期结果:客户端收到响应后,可读取到 X-Server-Time 和 X-App-Version 两个自定义头,其值分别为当前时间戳和固定版本号。
客户端如何发送携带自定义请求头的HTTP请求
客户端使用 g.Client() 创建实例后,调用 SetHeader() 方法预设自定义请求头,后续所有由该客户端发出的请求都会自动携带这些头信息。这种方式适用于全局统一添加认证令牌、追踪ID等场景。


















