net/http 可直接启动生产级服务器,无需第三方框架;需注意端口权限、表单与JSON解析区别、静态文件服务配置及中间件编写规范。

用 net/http 启动最简 Web 服务器,别碰第三方框架先
Go 自带的 net/http 足够跑生产级服务,多数场景根本不需要 Gin、Echo。直接调用 http.ListenAndServe 就能启动,连路由注册都只需几行:
package main
import (
"fmt"
"net/http"
)
func handler(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "Hello, %s", r.URL.Path[1:])
}
func main() {
http.HandleFunc("/", handler)
http.ListenAndServe(":8080", nil)
}
注意:http.ListenAndServe 第二个参数为 nil 时,会使用默认的 http.DefaultServeMux;若传入自定义 http.ServeMux 实例,则必须显式注册路由,否则 404。
常见错误:本地测试时绑定 ":80" 导致权限拒绝——普通用户无法监听 1024 以下端口,改用 ":8080" 或加 sudo(不推荐)。
处理 POST 表单和 JSON 请求,r.ParseForm() 和 json.Decode() 别混用
表单提交(application/x-www-form-urlencoded)和 JSON(application/json)解析方式完全不同,不能靠同一个方法覆盖:
立即学习“go语言免费学习笔记(深入)”;
-
r.ParseForm()只解析表单数据,结果存在r.Form和r.PostForm中,对 JSON 请求无效 - JSON 必须用
json.NewDecoder(r.Body).Decode(&v),且需在读取前检查r.Header.Get("Content-Type")是否匹配 - 读过一次
r.Body后不可重读,若需多次解析(如日志 + 业务),得用io.ReadAll缓存再构造新bytes.Reader
典型错误:对 JSON 请求调用 r.ParseForm() 后发现 r.PostForm 为空,却误以为是前端没发数据。
静态文件服务别硬编码路径,用 http.FileServer + http.StripPrefix
提供 /static/ 下的 CSS/JS 图片,不要手写 os.Open 拼路径。正确组合是:
Destoon B2B网站管理系统是一套完善的B2B(电子商务)行业门户解决方案。系统基于PHP+MySQL开发,采用B/S架构,模板与程序分离,源码开放。模型化的开发思路,可扩展或删除任何功能;创新的缓存技术与数据库设计,可负载千万级别数据容量及访问。 系统特性1、跨平台。支持Linux/Unix/Windows服务器,支持Apache/IIS/Zeus等2、跨浏览器。基于最新Web标准构建,在
fs := http.FileServer(http.Dir("./static"))
http.Handle("/static/", http.StripPrefix("/static/", fs))
关键点:
-
http.Dir参数是磁盘上的绝对或相对路径,不是 URL 路径 -
http.StripPrefix的第一个参数必须以/开头且与Handle的 pattern 一致,否则文件路径会多出前缀导致 404 - 该方案默认禁止目录遍历(如
/static/../etc/passwd),无需额外过滤
容易忽略:开发时习惯把静态资源放 ./public,但上线后可能部署在 CDN,这时应把静态资源路径改为绝对 URL,而非依赖 FileServer。
HTTP 中间件怎么写?用 func(http.Handler) http.Handler 而非装饰器模式
Go 没有 Python 那种 @decorator 语法,中间件本质是“包装 Handler 的函数”。标准签名是:
func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
log.Printf("Started %s %s", r.Method, r.URL.Path)
next.ServeHTTP(w, r)
})
}
使用时链式包裹:
handler := loggingMiddleware(
authMiddleware(
http.HandlerFunc(yourHandler),
),
)
要点:
- 必须返回
http.Handler,不能返回闭包函数本身(类型不匹配) - 中间件顺序很重要:越靠外的越早执行(如日志)、越靠内的越晚执行(如业务 handler)
- 若中间件需中断流程(如鉴权失败),直接写响应并 return,不要调用
next.ServeHTTP
真实陷阱:有人试图在中间件里修改 w.Header() 后继续调用 next,但若下游已写入 body,Header 修改将被忽略且无报错。









