Go语言零到一:构建 Web 应用（go语言写web服务器）

deer332025-08-03技术文章25

引言

net/http 包是 Go 语言的标准库之一，提供了构建 Web 服务器所需的几乎所有功能。从简单的 HTTP 服务器到复杂的 RESTful API，都可以通过这个包来实现。

1. 创建基本的 Web 服务器

package main

import (
  "fmt"
  "net/http"
)

func helloWorldHandler(w http.ResponseWriter, r *http.Request) {
  fmt.Fprintf(w, "Hello, World!")
}

func main() {
  http.HandleFunc("/", helloWorldHandler)
  if err := http.ListenAndServe(":8080", nil); err != nil {
    panic(err)
  }
}

这段代码定义了一个简单的 HTTP 请求处理器 helloWorldHandler，它向客户端返回一个简单的字符串 "Hello, World!"。然后，使用 http.HandleFunc 将根路径 / 与处理器关联，并通过 http.ListenAndServe 启动服务器监听 8080 端口。

2. 处理请求

在 Go 中，HTTP 请求由 *http.Request 类型表示，它包含请求的所有细节，如方法（GET、POST 等）、URL、头信息等。响应则通过 http.ResponseWriter 接口来控制。

func infoHandler(w http.ResponseWriter, r *http.Request) {
  fmt.Fprintf(w, "Method: %s\n", r.Method)
  fmt.Fprintf(w, "URL: %s\n", r.URL.Path)
  fmt.Fprintf(w, "Headers:\n")
  for k, v := range r.Header {
    fmt.Fprintf(w, "%s: %s\n", k, v)
  }
}

3. 发送响应

响应可以通过 http.ResponseWriter 来设置状态码、写入头部信息以及向客户端发送数据。

func respondWithJSON(w http.ResponseWriter, status int, payload interface{}) {
  response, _ := json.Marshal(payload)
  w.Header().Set("Content-Type", "application/json")
  w.WriteHeader(status)
  w.Write(response)
}

4. 文件服务

net/http 包内置了静态文件服务的功能，可以方便地为客户端提供静态文件。

func main() {
  http.Handle("/", http.FileServer(http.Dir("./public")))
  http.HandleFunc("/api/hello", helloWorldHandler)
  http.ListenAndServe(":8080", nil)
}

这里，http.FileServer 创建了一个文件服务器，http.Dir 指定了文件所在的目录。

5. 中间件

中间件是一种常见的设计模式，在 Go 的 Web 开发中也很流行。中间件可以用来添加通用的功能，如日志记录、认证、跨域支持等。

func loggingMiddleware(next http.Handler) http.Handler {
  return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    start := time.Now()
    next.ServeHTTP(w, r)
    fmt.Printf("%s %s %s\n", r.Method, r.URL, time.Since(start))
  })
}

func main() {
  mux := http.NewServeMux()
  mux.HandleFunc("/", helloWorldHandler)
  mux.HandleFunc("/api/hello", helloWorldHandler)

  server := &http.Server{
    Addr:    ":8080",
    Handler: loggingMiddleware(mux),
  }

  if err := server.ListenAndServe(); err != nil {
    panic(err)
  }
}

这里定义了一个简单的日志记录中间件 loggingMiddleware，并在 main 函数中将其应用于所有的请求处理。

6. 示例代码

以下通将展示如何使用 net/http 构建一个支持基本路由、静态文件服务和中间件的 Web 服务器。

package main

import (
  "encoding/json"
  "fmt"
  "log"
  "net/http"
  "time"
)

type user struct {
  Name string `json:"name"`
  Age  int    `json:"age"`
}

func helloWorldHandler(w http.ResponseWriter, r *http.Request) {
  fmt.Fprint(w, "Hello, World!")
}

func userHandler(w http.ResponseWriter, r *http.Request) {
  user := user{Name: "John Doe", Age: 30}
  respondWithJSON(w, http.StatusOK, user)
}

func respondWithJSON(w http.ResponseWriter, status int, payload interface{}) {
  response, _ := json.Marshal(payload)
  w.Header().Set("Content-Type", "application/json")
  w.WriteHeader(status)
  w.Write(response)
}

func loggingMiddleware(next http.Handler) http.Handler {
  return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
    start := time.Now()
    next.ServeHTTP(w, r)
    log.Printf("%s %s %s", r.Method, r.URL, time.Since(start))
  })
}

func main() {
  mux := http.NewServeMux()
  mux.HandleFunc("/", helloWorldHandler)
  mux.HandleFunc("/api/user", userHandler)
  mux.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./public"))))

  server := &http.Server{
    Addr:    ":8080",
    Handler: loggingMiddleware(mux),
  }

  log.Println("Starting server on :8080...")
  if err := server.ListenAndServe(); err != nil {
    log.Fatal(err)
  }
}

7. 推荐 Go Web 框架

7.1 Echo

GitHub: https://github.com/labstack/echo
简介: Echo 是一个高性能、简洁且可扩展的 Go Web 框架，支持 HTTP/2 和 HTTPS。它提供了一个灵活的中间件栈，支持路由参数、静态文件服务、JSON 编码等特性。
特点: 快速、轻量级、可插拔的中间件。

7.2 Gin

GitHub: https://github.com/gin-gonic/gin
简介: Gin 是一个高性能的 Go Web 框架，非常适合构建 Web 应用程序和 RESTful 服务。它具有极高的性能，并且提供了丰富的功能，如路由、中间件、绑定和验证等。
特点: 高性能、灵活性强、易于使用。

7.3 Beego

GitHub: https://github.com/beego/beego
简介: Beego 是一个成熟的 Go Web 框架，提供了 MVC 架构、内置 ORM、RESTful API 支持等功能。它适合于构建大型企业级应用。
特点: 完整的生态系统、内置 ORM、模板引擎。

7.4 Iris

GitHub: https://github.com/kataras/iris
简介: Iris 是一个高性能且易于使用的 Go Web 框架，支持多种模板引擎、WebSocket、静态文件服务等功能。它提供了一个丰富的功能集，适合快速开发 Web 应用程序。
特点: 灵活性高、多种模板引擎支持、WebSocket 支持。

7.5 Revel

GitHub: https://github.com/revel/revel
简介: Revel 是一个高性能且全栈的 Go Web 框架，提供了自动代码重载、内置测试工具等功能。它非常适合于构建大规模 Web 应用程序。
特点: 自动代码重载、内置测试工具、全栈开发。

7.6 Fiber

GitHub: https://github.com/gofiber/fiber
简介: Fiber 是一个高度可定制且高性能的 Go Web 框架，基于 Net/http 包，提供了中间件支持、静态文件服务等功能。它非常适合于构建高性能 Web 应用程序。
特点: 高性能、高度可定制、易于使用。