0

0

如何使用Golang实现简单的HTTP服务器_Golang HTTP服务器快速搭建与请求处理

P粉602998670

P粉602998670

发布时间:2026-01-07 16:11:02

|

505人浏览过

|

来源于php中文网

原创

用 net/http 启动最简 HTTP 服务器只需三行代码:导入 net/http,调用 http.HandleFunc 注册路由,再执行 http.ListenAndServe 监听端口;默认处理器返回 404,需显式注册路径;支持函数式注册与自定义 Handler 接口实现,后者更利于测试、依赖注入和中间件扩展。

如何使用golang实现简单的http服务器_golang http服务器快速搭建与请求处理

net/http 启动最简 HTTP 服务器

Go 自带的 net/http 包不需要额外依赖,三行代码就能跑起来。核心是调用 http.ListenAndServe,它会阻塞当前 goroutine,监听指定地址并处理请求。

常见错误是端口被占用或权限不足(如监听 :80 在非 root 用户下失败),建议开发时优先用 :8080 或更高端口。

package main

import "net/http"

func main() {
    http.ListenAndServe(":8080", nil)
}

此时服务器能启动,但所有请求都返回 404 —— 因为没注册任何路由处理器

注册路由:用 http.HandleFunc 处理路径

http.HandleFunc 是最常用的注册方式,它把路径字符串和处理函数绑定到默认的 http.DefaultServeMux 上。注意路径匹配是前缀匹配,"/api" 会同时匹配 /api/api/users

立即学习go语言免费学习笔记(深入)”;

  • 路径末尾加 /(如 "/hello/")会让 mux 自动重定向带斜杠的请求,适合目录式路由
  • 不加斜杠则严格匹配完整路径,更可控
  • 多个 HandleFunc 注册顺序无关,mux 内部按最长前缀匹配
package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/hello", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello, %s!", r.URL.Query().Get("name"))
    })
    http.ListenAndServe(":8080", nil)
}

自定义处理器:实现 http.Handler 接口

当逻辑变复杂、需要状态或复用时,直接写函数不够用。Go 的 http.Handler 是一个接口:func ServeHTTP(http.ResponseWriter, *http.Request)。任何实现了它的类型都能当处理器。

蛙蛙写作——超级AI智能写作助手
蛙蛙写作——超级AI智能写作助手

蛙蛙写作辅助AI写文,帮助获取创意灵感,提供拆书、小说转剧本、视频生成等功能,是一款功能全面的AI智能写作工具。

下载

比起 HandleFunc,自定义结构体更易测试、可注入依赖(比如数据库连接、配置)、支持中间件链式调用。

  • 不要在 ServeHTTP 里 panic,否则整个服务器可能崩溃;应统一用 http.Error 返回错误响应
  • 如果嵌套多个 Handler(如用 http.StripPrefix),注意路径修改后 r.URL.Path 是否已更新
  • 避免在 Handler 中长时间阻塞,除非明确做了超时控制或启用了 goroutine
type Greeter struct {
    prefix string
}

func (g Greeter) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    name := r.URL.Query().Get("name")
    if name == "" {
        http.Error(w, "missing 'name'", http.StatusBadRequest)
        return
    }
    fmt.Fprintf(w, "%s, %s!", g.prefix, name)
}

func main() {
    http.Handle("/greet", Greeter{prefix: "Hi"})
    http.ListenAndServe(":8080", nil)
}

处理 POST 表单与 JSON 请求

GET 请求参数从 r.URL.Query() 拿;POST 表单(application/x-www-form-urlencoded)需先调用 r.ParseForm(),再读 r.FormValue;JSON 则要手动读取 r.Body 并解码。

容易忽略的是:多次调用 r.FormValuer.PostFormValue 不会重复解析,但 r.Body 只能读一次 —— 如果之前调用了 ParseFormParseMultipartFormr.Body 已被消费,直接读会得到空内容。

  • 对 JSON,推荐用 json.NewDecoder(r.Body).Decode(&v),比 ioutil.ReadAll + json.Unmarshal 更省内存
  • 表单字段名区分大小写,r.FormValue("Name")r.FormValue("name") 是不同的
  • 没有显式设置 Content-Type 时,ParseForm 仍会尝试解析,但可能误判编码;建议前端明确发送 Content-Type: application/x-www-form-urlencoded

实际开发中,别只靠 http.HandleFunc 硬写逻辑,早一点封装成结构体 Handler,不然加日志、鉴权、限流时会很难维护。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

177

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

336

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

Golang 分布式缓存与高可用架构
Golang 分布式缓存与高可用架构

本专题系统讲解 Golang 在分布式缓存与高可用系统中的应用,涵盖缓存设计原理、Redis/Etcd集成、数据一致性与过期策略、分布式锁、缓存穿透/雪崩/击穿解决方案,以及高可用架构设计。通过实战案例,帮助开发者掌握 如何使用 Go 构建稳定、高性能的分布式缓存系统,提升大型系统的响应速度与可靠性。

27

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号