如何使用Golang实现RESTful API_Golang REST接口设计与请求处理方法_网络技术

如何使用Golang实现RESTful API_Golang REST接口设计与请求处理方法

发布时间 - 2026-01-08 00:00:00 点击率：次

net/http 可构建轻量 REST 服务：需手动精确匹配路径、解析 URL 参数、一次性读取 Body、导出结构体字段并加 json tag、校验 Content-Type、用 http.Error 或封装函数返回错误、显式处理 OPTIONS 预检并设置 CORS 头。

用 `net/http` 启动最简 REST 服务，别急着上框架

Go 原生 net/http 完全够用，尤其在中小规模 API 场景。过早引入 gin 或 echo 反而掩盖路由匹配、中间件执行顺序等关键细节。

http.HandleFunc 注册路径时，前缀匹配是隐式的：注册 /api/users 会同时响应 /api/users/123 —— 需手动检查 r.URL.Path 是否精确匹配
使用 http.ServeMux 自定义路由时，注意它不支持路径参数（如 /users/{id}），必须自己解析 r.URL.Path 并提取 id

启动服务务必显式指定端口和错误处理：

if err := http.ListenAndServe(":8080", nil); err != nil && err != http.ErrServerClosed {
    log.Fatal(err)
}

正确解析 JSON 请求体，避免 `io.EOF` 和空结构体

常见错误是直接对 http.Request.Body 多次调用 json.Unmarshal —— Body 是单次读取流，第二次读就会返回 io.EOF。

始终用 io.ReadAll(r.Body) 一次性读完，再传给 json.Unmarshal；不要试图复用 r.Body
结构体字段必须首字母大写且带 json tag，否则反序列化后字段为空：type User struct { Name string `json:"name"` }
用 r.Header.Get("Content-Type") 检查是否为 application/json，非 JSON 请求应返回 415 Unsupported Media Type

用 `http.Error` 统一返回错误，别拼接字符串

手写 w.WriteHeader(400); w.Write([]byte(`{"error":"xxx"}`)) 容易遗漏状态码、Content-Type 或格式不一致。

优先用 http.Error(w, "bad request", http.StatusBadRequest)，它自动设状态码和 text/plain 类型

若需返回 JSON 错误，单独封装函数：

func writeJSONError(w http.ResponseWriter, msg string, code int) {
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(code)
    json.NewEncoder(w).Encode(map[string]string{"error": msg})
}

注意 http.Error 不会终止 handler 执行，后续代码仍会运行，必要时加 return

处理 CORS 时，`OPTIONS` 预检请求必须显式响应

浏览器发跨域请求前会先发 OPTIONS，如果没处理，前端卡在 pending 状态，控制台只显示 “CORS error”。

在 handler 开头判断：if r.Method == "OPTIONS" { w.WriteHeader(http.StatusOK); return }
必须设置以下响应头：Access-Control-Allow-Origin、Access-Control-Allow-Methods、Access-Control-Allow-Headers
如果允许携带 cookie，还需加 Access-Control-Allow-Credentials: true，且 Allow-Origin 不能为 *

实际项目里，最难调试的往往是预检失败和 Body 重复读取——这两个点没踩过坑的人，多半还没真正跑通第一个 POST 接口。

# js # 前端 # json # go # cookie # golang # 浏览器 # app # access # 端口 # usb # ai # 路由 # 跨域 # restful # 中间件 # gin # echo # EOF # String # if # 封装

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：VM虚拟机如何下载及安装

下一篇：百度云盘网页版在线登录方法_百度网盘网页版电脑端登录入口

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：VM虚拟机如何下载及安装

下一篇：百度云盘网页版在线登录方法_百度网盘网页版电脑端登录入口

如何使用Golang实现RESTful API_Golang REST接口设计与请求处理方法

用 net/http 启动最简 REST 服务，别急着上框架

正确解析 JSON 请求体，避免 io.EOF 和空结构体

用 http.Error 统一返回错误，别拼接字符串

处理 CORS 时，OPTIONS 预检请求必须显式响应

用 `net/http` 启动最简 REST 服务，别急着上框架

正确解析 JSON 请求体，避免 `io.EOF` 和空结构体

用 `http.Error` 统一返回错误，别拼接字符串

处理 CORS 时，`OPTIONS` 预检请求必须显式响应