不能在 goroutine 里直接用 ctx.PostBody()，因为 fasthttp 复用 *fasthttp.RequestCtx 对象，PostBody() 返回的 []byte 指向底层共享缓冲区，延迟读取会导致脏数据或 panic；必须立即复制，如 body := append([]byte(nil), ctx.PostBody()...)。
为什么不能在 goroutine 里直接用 ctx.PostBody()
因为 fasthttp 复用 *fasthttp.RequestCtx 对象，不是每次请求新建一个——这是它比 net/http 快的核心机制，但也是最常翻车的地方。
一旦你在 goroutine 里延迟读取 ctx.PostBody() 返回的 []byte，那个底层数组可能已经被下一个请求覆盖了，结果就是读到脏数据、panic 或静默错乱。
- ❌ 错误写法：
go func() { data := ctx.PostBody(); processAsync(data) }()——data是原始切片，指向复用缓冲区 - ✅ 正确做法：立即复制一份：
body := append([]byte(nil), ctx.PostBody()...)
或body := make([]byte, len(ctx.PostBody())); copy(body, ctx.PostBody())
- 同理适用于
ctx.QueryArgs().Peek("key")、ctx.Request.Header.Peek("User-Agent")等所有返回底层缓冲区引用的方法
ListenAndServe 启动失败的常见原因和排查点
fasthttp.ListenAndServe 看似简单，但启动报错往往不提示具体原因，容易卡住调试。
-
address already in use：端口被占，但错误信息可能被吞掉；建议先用lsof -i :8080（macOS/Linux）或netstat -ano | findstr :8080（Windows）确认 - 监听
localhost:8080却从外部访问不到？默认只绑127.0.0.1；要外网可访问，改用":8080"（即空 host） - 没加
log.Fatal包裹，错误被忽略：if err := fasthttp.ListenAndServe(":8080", h); err != nil { log.Fatal(err) } - HTTPS 需用
ListenAndServeTLS，且证书路径不能为空字符串；若用自签名，需传入有效 PEM 文件路径，不能留""
怎么安全地加中间件（比如日志、压缩、超时）
fasthttp 没有内置中间件链，但可以通过函数包装实现，关键是不能破坏 ctx 的生命周期语义。
立即学习“go语言免费学习笔记（深入）”；
- 日志中间件必须在 handler 执行前后立刻读取字段：
ctx.Method()、ctx.Path()、ctx.StatusCode()都是安全的；但别在 defer 里读ctx.Response.Body()——还没写完 - 压缩要用
fasthttp.CompressHandler，它内部已处理好 header 和 body 缓冲复用；自己手动 gzip 容易绕过缓冲池，反而拖慢 - 超时控制不能靠
time.AfterFunc杀 goroutine（不安全），推荐用ctx.Timeout() > 0+ 主动检查，或在外层用fasthttp.Server结构体配ReadTimeout/WriteTimeout - 示例包装：
func withLogging(next fasthttp.RequestHandler) fasthttp.RequestHandler { return func(ctx *fasthttp.RequestCtx) { start := time.Now() next(ctx) log.Printf("%s %s %d %v", ctx.Method(), ctx.Path(), ctx.Response.StatusCode(), time.Since(start)) } }
要不要换路由库？fasthttprouter 和原生 RequestCtx 怎么配合
原生 fasthttp 不带路由，但强行手写 if path == "/api/user" {...} 很快会失控；用路由库是合理选择，只是要注意兼容性。
-
github.com/buaazp/fasthttprouter是最常用选项，API 类似gorilla/mux，支持参数提取：:id、*path - 它返回的 handler 类型是
func(*fasthttp.RequestCtx, map[string]string)，第二个参数是 params，不是标准fasthttp.RequestHandler；需包装一层：r.HandlerFunc("GET", "/user/:id", func(ctx *fasthttp.RequestCtx, ps map[string]string) { id := ps["id"]; ... }) - 别混用多个路由库（比如同时引
fasthttprouter和fasthttp-routing），它们对ctx的修改逻辑可能冲突 - 如果路由规则简单（≤5 条），直接用
switch string(ctx.Path())更轻量、无额外分配
ctx 是复用的、PostBody() 返回的是指针、而 log.Printf 里的格式化字符串本身就会触发 GC。这些细节不写进日志，也不报错，只在压测时悄悄拖垮 P99 延迟。 
