跳到主要内容
Go Web 开发核心基础:HTTP 协议与实战指南 | 极客日志
Go / Golang
Go Web 开发核心基础:HTTP 协议与实战指南 HTTP 状态码涵盖 2xx 成功至 5xx 服务器错误,是 Web 通信的基础共识。HTTP 协议基于请求 - 响应模型,无状态特性通过 Cookie 和 Session 补充。URL 结构包含协议、域名、端口及参数。GET 与 POST 在语义、幂等性及缓存策略上存在本质差异。MySQL 操作推荐使用 sqlx 库简化查询。Cookie 用于客户端存储会话,Session 管理服务端状态。模板引擎实现视图与控制层解耦。文件上传需处理 multipart/form-data,下载则设置正确的响应头。掌握这些核心概念是构建稳定 Go Web 应用的前提。
雾岛听风 发布于 2026/3/29 更新于 2026/4/25 3 浏览HTTP 状态码
每个状态码都是 HTTP 设计者对网络通讯中可能出现情况的预判,相当于现实世界的信号灯。这种共识是万维网高效运行的基础之一。
必须掌握的状态码
200 OK :请求完全正确,最常见,如打开网页或调用 API。
301 Moved Permanently :资源永久迁移,例如访问 a.com 会被重定向到 b.com。
302 Found :资源临时迁移。
400 Bad Request :请求出错,通常因参数缺失或格式错误。
401 Unauthorized :未登录,需要身份验证。
403 Forbidden :已登录但无权限访问。
404 Not Found :资源不存在。
500 Internal Server Error :服务器内部错误。
需要理解的状态码
排查问题时常用:
100 Continue :继续发送请求。
201 Created :资源创建成功(常用于 POST)。
204 No Content :处理成功但不返回资源(常用于 DELETE)。
206 Partial Content :部分资源处理成功。
304 Not Modified :资源未修改,直接使用缓存。
405 Method Not Allowed :请求方法不被允许。
408 Request Timeout :请求超时。
502 Bad Gateway :网关/代理收到无效响应。
503 Service Unavailable :服务器暂不可用。
HTTP 协议
核心概念
本质 :超文本传输协议,基于【请求 + 响应】模型,客户端发送请求、服务器响应,一问一答传递信息。
无状态 :服务器默认不记住上一次请求,后期通过 Cookie 和 Session 解决。
位置 :应用层协议,规范客户端与服务器的传输格式及交互流程。
URL 结构
以 https://www.example.com:8080/path?name=test#fragment 为例:
https:协议类型。
www.example.com:域名,对应服务器 IP。
8080:端口,HTTP 默认 80,HTTPS 默认 443,可省略。
/path:资源路径。
?name=test:GET 请求携带的参数。
#fragment:锚点。
请求方法 (Method)
GET :仅请求资源,不影响服务器数据。
POST :提交数据,在服务器创建新资源。
PUT :更新数据,若无资源则新建,具有幂等性。
DELETE :删除数据,通常返回 204。
:修改部分资源,不同于 PUT 的整资源更新。
PATCH
HTTP 版本演进
HTTP/1.0 :每次访问重新建立连接。
HTTP/1.1 :支持持久化连接,但只能串行发送请求。
HTTP/2 :多路复用,一个连接同时发多个请求互不阻塞。
HTTP/3 :引入 UDP,解决 TCP 队头阻塞问题。
缓存机制
强缓存 :通过 Cache-Control: max-age=3600 告诉浏览器 1 小时内强制使用本地缓存,除非强制刷新。
协商缓存 :强缓存过期后,浏览器带 If-Modified-Since 或 Etag 请求,服务器判断未修改则返回 304。
HTTPS 原理 HTTPS = HTTP + TLS。核心区别在于数据加密。
加密 :将明文变为密文,防止截获破解。
身份认证 :验证服务器身份,防止钓鱼网站。
完整性校验 :确保信息未被篡改。
Cookie 和 Session
Cookie :服务器通过 Set-Cookie 在客户端存储信息,解决 HTTP 无状态问题。
Session :服务端存储用户信息,与 Cookie 中的 session_id 关联。登录时设置 session_id,后续通过该 ID 查找会话信息。
跨域资源共享 (CORS) 同源策略指协议、域名、端口有一个不同即不属于同一域。解决跨域需服务器返回 Access-Control-Allow-Origin 响应头,允许指定域名请求。
MySQL 的连接与增删改查 本篇通过 sqlx 包操作数据库,对通用 SQL 操作进行了拓展。
连接 import (
_ "github.com/go-sql-driver/mysql"
"github.com/jmoiron/sqlx"
)
DB, err := sqlx.Open("mysql" , "root:password@tcp(localhost:3306)/goweb?parseTime=true&loc=Local" )
if err != nil {
panic (err)
}
err = DB.Ping()
增删改查
queryCreate := "INSERT INTO user (id, name) VALUES (?, ?)"
queryDelete := "DELETE FROM user WHERE id = ?"
queryUpdate := "UPDATE user SET name = ? WHERE id = ?"
queryQuery := "SELECT * FROM user"
_, err := DB.Exec(queryCreate, 1 , "白小纯" )
_, err = DB.Exec(queryDelete, 1 )
_, err = DB.Exec(queryUpdate, "夜藏" , 1 )
rows, err := DB.Query(queryQuery)
for rows.Next() {
var id int
var name string
rows.Scan(&id, &name)
}
Cookie 实战
后端核心操作 func handleCookie (w http.ResponseWriter, r *http.Request) {
cookie := &http.Cookie{
Name: "session_id" ,
Value: "cookie_value" ,
Expires: time.Now().Add(time.Hour),
}
http.SetCookie(w, cookie)
c, err := r.Cookie("session_id" )
if err == nil {
fmt.Fprintf(w, "%s %s %v" , c.Name, c.Value, c.Expires)
}
cs := r.Cookies()
for _, co := range cs {
fmt.Println(co.Name, co.Value)
}
}
模板引擎 模板起源于批量生产特定物品的需求,Web 领域为了解耦控制器 (Controller) 与视图 (View),引入了模板引擎。简单来说,它是包含占位符与控制逻辑的预制文本结构。
func handleTemplate (w http.ResponseWriter, r *http.Request) {
add := template.FuncMap{"add" : AddFunc}
t := template.New("index" ).Funcs(add)
t, _ = t.ParseFiles("new_add" )
t.Execute(w, nil )
}
文件上传与下载
上传 从浏览器向服务器传输数据,表单需设置 enctype="multipart/form-data"。
func handleUpload (w http.ResponseWriter, r *http.Request) {
err := r.ParseMultipartForm(32 << 20 )
if err != nil {
return
}
f, _, err := r.FormFile("photo" )
if err != nil {
return
}
defer f.Close()
b, _ := io.ReadAll(f)
err = os.WriteFile("/tmp/photo.jpg" , b, 0777 )
if err != nil {
fmt.Println("保存失败" )
}
}
<form action ="/upload" enctype ="multipart/form-data" method ="post" >
<input type ="file" name ="photo" >
<button type ="submit" > 上传</button >
</form >
下载 func handleDownload (w http.ResponseWriter, r *http.Request) {
filename := r.FormValue("filename" )
data, err := os.ReadFile(filename)
if err != nil {
return
}
h := w.Header()
h.Set("Content-Type" , "application/octet-stream" )
h.Set("Content-Disposition" , "attachment; filename=" +filename)
w.Write(data)
}
<a href ="/download?filename=file.png" > 点击下载</a >
控制器模式
单控制器 type MyHandler struct {}
func (m MyHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
}
func main () {
server := http.Server{
Addr: "localhost:8888" ,
Handler: MyHandler{},
}
server.ListenAndServe()
}
多控制器 func TestHandler (w http.ResponseWriter, r *http.Request) {
}
func main () {
server := http.Server{
Addr: "localhost:8888" ,
}
http.HandleFunc("/url" , TestHandler)
server.ListenAndServe()
}
GET 与 POST 核心区别 角度 GET POST 语义 获取资源 提交资源 参数 URL 中可见 请求体中隐藏 幂等性 多次执行结果不变 可能多次提交(非幂等) 缓存 易被缓存 一般不缓存
掌握这些核心概念是构建稳定 Go Web 应用的前提。
相关免费在线工具 Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
Markdown转HTML 将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
HTML转Markdown 将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
JSON 压缩 通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
JSON美化和格式化 将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online