Golang如何用 net/http 搭建简单服务器_Golang net/http 服务器开发实战-Golang-PHP中文网

Golang如何用 net/http 搭建简单服务器_Golang net/http 服务器开发实战

P粉602998670

发布： 2025-11-17 18:35:02

原创

385人浏览过

用Golang搭建HTTP服务器只需几行代码，通过net/http包实现路由、处理请求与响应。首先使用http.HandleFunc注册路径及处理函数，再调用http.ListenAndServe启动服务。示例中根路径返回“Hello, 你好！”，并可扩展多个路由如/home和/api/user。支持GET和POST请求处理，分别获取查询参数与表单数据。返回JSON时设置Content-Type为application/json，并用json.NewEncoder编码以优化内存。该方案轻量高效，适合构建简单Web服务或API。

golang如何用 net/http 搭建简单服务器_golang net/http 服务器开发实战

用 Golang 搭建一个简单的 HTTP 服务器非常直接，net/http 包提供了开箱即用的功能，不需要引入第三方框架也能快速实现路由、处理请求和返回响应。

初始化一个基础 HTTP 服务器

最简单的服务器只需要几行代码。调用 http.HandleFunc 设置路径对应的处理函数，再用 http.ListenAndServe 启动服务。

package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello, 你好！请求路径: %s", r.URL.Path)
    })

    fmt.Println("服务器启动在 :8080")
    http.ListenAndServe(":8080", nil)
}

登录后复制

运行后访问 http://localhost:8080 就能看到返回内容。这个例子中，所有请求都由匿名函数处理，w 用于写入响应，r 是请求对象，可读取路径、参数、Header 等信息。

注册多个路由处理函数

你可以为不同路径注册不同的处理逻辑。每个路径对应一个处理函数，便于组织业务。

立即学习“go语言免费学习笔记（深入）”；

http.HandleFunc("/home", homeHandler)
http.HandleFunc("/api/user", userHandler)

func homeHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, "这是首页")
}

func userHandler(w http.ResponseWriter, r *http.Request) {
    fmt.Fprintln(w, `{"id": 1, "name": "Tom"}`)
}

登录后复制

这样访问 /home 和 /api/user 会返回不同内容。注意路径匹配是前缀匹配，更精确的路由建议配合 http.ServeMux 或使用第三方路由器如 gorilla/mux。

Giiso写作机器人

Giiso写作机器人，让写作更简单

查看详情

处理 GET 和 POST 请求

通过判断 r.Method 可区分请求类型。GET 参数用 r.URL.Query() 获取，POST 表单数据用 r.ParseForm() 解析。

func handler(w http.ResponseWriter, r *http.Request) {
    if r.Method == "GET" {
        query := r.URL.Query().Get("q")
        fmt.Fprintf(w, "搜索词: %s", query)
    }

    if r.Method == "POST" {
        r.ParseForm()
        name := r.FormValue("name")
        fmt.Fprintf(w, "收到名字: %s", name)
    }
}

登录后复制

前端可以用表单或 fetch 发送 POST 请求测试。记得设置 Content-Type，比如表单提交时默认是 application/x-www-form-urlencoded。

返回 JSON 响应

返回结构化数据时通常用 JSON。手动拼接字符串容易出错，推荐使用 json.Marshal 并设置 Header。

import "encoding/json"

func apiHandler(w http.ResponseWriter, r *http.Request) {
    data := map[string]interface{}{
        "code": 0,
        "msg":  "success",
        "data": []string{"Go", "Java", "Python"},
    }

    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(data)
}

登录后复制

设置 Content-Type 能让客户端正确解析响应。使用 json.NewEncoder(w).Encode 可直接写入响应流，节省内存。

基本上就这些。net/http 足够轻量又强大，适合搭建 API 服务或简单 Web 应用。不复杂但容易忽略细节，比如错误处理、超时控制和静态文件服务，后续可逐步扩展。

以上就是Golang如何用 net/http 搭建简单服务器_Golang net/http 服务器开发实战的详细内容，更多请关注php中文网其它相关文章！