Golang搭建Web服务器教程合集

学习Golang要努力，但是不要急！今天的这篇文章《Golang构建Web服务器教程汇总》将会介绍到等等知识点，如果你想深入学习Golang，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

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）解析方式完全不同，不能靠同一个方法覆盖：

• 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 拼路径。正确组合是：

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 修改将被忽略且无报错。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~