0

0

Golang实现简单的RESTful接口示例

P粉602998670

P粉602998670

发布时间:2026-01-11 15:47:02

|

513人浏览过

|

来源于php中文网

原创

用net/http可实现轻量RESTful路由:通过预定义路径-方法映射表分发请求,手动解析URL路径参数并校验,显式设置JSON响应头,避免隐式状态。

golang实现简单的restful接口示例

用 net/http 实现最简 RESTful 路由

Go 标准库 net/http 本身不带路由功能,但完全够用——不需要引入第三方框架也能写出清晰、可维护的 RESTful 接口。关键在于手动匹配 req.URL.Pathreq.Method,而不是依赖复杂中间件。

常见错误是直接写一堆 if req.URL.Path == "/users" && req.Method == "GET",结果分支嵌套深、难测试、无法复用。更稳妥的做法是提前注册路由表,再统一分发:

package main

import (
	"fmt"
	"log"
	"net/http"
)

type handlerFunc func(http.ResponseWriter, *http.Request)

var routes = map[string]map[string]handlerFunc{
	"/users": {
		"GET":    getUsers,
		"POST":   createUser,
		"DELETE": deleteUser,
	},
}

func main() {
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		if h, ok := routes[r.URL.Path][r.Method]; ok {
			h(w, r)
			return
		}
		http.Error(w, "404 not found", http.StatusNotFound)
	})
	log.Fatal(http.ListenAndServe(":8080", nil))
}

func getUsers(w http.ResponseWriter, r *http.Request) {
	fmt.Fprint(w, `[{"id":1,"name":"alice"}]`)
}

func createUser(w http.ResponseWriter, r *http.Request) {
	w.WriteHeader(http.StatusCreated)
	fmt.Fprint(w, `{"id":2,"name":"bob"}`)
}

func deleteUser(w http.ResponseWriter, r *http.Request) {
	w.WriteHeader(http.StatusNoContent)
}

解析 URL 路径参数(如 /users/123)

net/http 不自动提取路径参数,得自己切分 r.URL.Path。别用正则硬匹配,容易漏掉边界情况;推荐用 strings.Split + 长度判断,简单可靠。

  • 路径如 /users/123,应先检查 len(parts) == 3 && parts[0] == "" && parts[1] == "users"
  • 避免直接取 parts[2] 而不校验长度,否则 panic
  • 数字 ID 建议用 strconv.Atoi 转换,并检查 error

示例片段(接上文):

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

网趣网上购物系统旗舰版
网趣网上购物系统旗舰版

网趣网上购物系统支持PC电脑版+手机版+APP,数据一站式更新,支持微信支付与支付宝支付接口,是专业的网上商城系统,网趣商城系统支持淘宝数据包导入,实现与淘宝同步更新!支持上传图片水印设置、图片批量上传功能,同时支持订单二次编辑以及多级分类隐藏等实用功能,新版增加商品大图浏览与列表显示功能,使分类浏览更方便,支持最新的支付宝即时到帐接口。

下载
func getUserByID(w http.ResponseWriter, r *http.Request) {
	parts := strings.Split(r.URL.Path, "/")
	if len(parts) != 3 || parts[1] != "users" {
		http.Error(w, "bad path", http.StatusBadRequest)
		return
	}
	id, err := strconv.Atoi(parts[2])
	if err != nil {
		http.Error(w, "invalid id", http.StatusBadRequest)
		return
	}
	fmt.Fprintf(w, `{"id":%d,"name":"user-%d"}`, id, id)
}

正确处理 JSON 请求体和响应头

很多初学者只写 json.Marshal,却忘了设 Content-Type: application/json,导致前端收到字符串而非 JSON 对象。同样,接收 POST/PUT 数据时,常忽略 req.Body 可能为空或已关闭的问题。

  • 响应前必须调用 w.Header().Set("Content-Type", "application/json; charset=utf-8")
  • 读取请求体前,确认 r.MethodPOSTPUT,且 r.ContentLength > 0
  • io.ReadAll(r.Body) 替代 json.NewDecoder(r.Body).Decode(...) 更安全——后者在 body 关闭后会静默失败

典型错误:没设 header 导致前端 response.json() 报错 “Unexpected token”。

为什么不用 gorilla/mux 或 chi?

不是不能用,而是过早引入会掩盖对底层机制的理解。比如:gorilla/muxVars(r) 看似方便,但一旦路由嵌套变深、中间件增多,调试 context 传递和变量生命周期反而更费时间。标准库写法虽然多几行,但每一步都可见、可控、无隐藏行为。

真正该警惕的是“隐式状态”:比如全局变量存用户 session、未关闭的数据库连接、忘记 recover 的 panic。这些比选哪个路由库重要得多。

相关专题

更多
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数组用法,想了解更多的相关内容,请阅读专题下面的文章。

192

2025.06.17

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

80

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号