Go语言如何实现简单API服务_REST接口基础实现

用 net/http 启最简 REST 服务需：1. 用 http.HandleFunc 绑定资源路径（如 /users）；2. 在处理函数中按 req.Method 区分 HTTP 方法；3. 显式设置状态码并用 json.NewEncoder 返回标准 json 响应。

用 net/http 启一个最简 REST 服务

go 原生 net/http 足够跑出符合 REST 风格的 API，不需要框架也能清晰表达资源语义。关键不是“能不能”，而是路由怎么映射、请求怎么解析、响应怎么组织。

核心是：用 http.HandleFunc 绑定路径和处理函数，再在函数里根据 req.Method 区分 GET/POST/PUT/delete；不要靠多个独立端口或 query 参数模拟动作。

• 所有路径应以资源为中心，比如 /users、/users/123
• 避免写成 /getUsers 或 /api?action=delete
• 处理函数必须显式检查 req.Method，否则容易忽略方法误用（比如用 GET 接收 JSON body）

解析 JSON 请求体并校验字段

Go 的 json.Unmarshal 默认对缺失字段静默容忍，直接解到 Struct 可能导致空值被当成合法输入。REST 接口要求明确失败反馈，不能靠客户端猜。

常见错误是只做 err != nil 判断，却没检查结构体字段是否为空或越界。例如接收用户创建请求时，Name 和 Email 应为必填，但默认 struct 解码不会报错。

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

• 给字段加 json:"name,omitempty" 不解决必填问题，要用自定义校验逻辑
• 推荐先用 json.RawMessage 做预读，再按需解码——避免 panic 或静默丢数据
• 对 POST /users 这类创建接口，返回 400 Bad Request 并附具体错误字段比返回 500 更合理

返回标准 JSON 响应与状态码

REST 接口的响应不是“有 JSON 就行”，而要匹配 HTTP 状态码语义。比如 GET /users/999 找不到资源，该返回 404 Not Found，而不是 200 OK 加个 {"Error": "not found"}。

Go 默认 http.ResponseWriter 的状态码是 200，不显式设置就永远 200。很多初学者漏掉这步，导致前端无法靠 status 判断流程分支。

• 用 w.WriteHeader(http.StatusNotFound) 显式设状态码，再写 body
• 统一响应结构推荐：包含 code（业务码）、message、data（可选），但不要和 HTTP status 冗余
• 别用 fmt.Fprintf(w, ...) 拼 JSON 字符串，用 json.NewEncoder(w).Encode(...) 防止格式错误和 xss 风险

package main  import ( 	"encoding/json" 	"log" 	"net/http" )  type User struct { 	ID   int    `json:"id"` 	Name string `json:"name"` 	Email string `json:"email"` }  var users = map[int]User{ 	1: {ID: 1, Name: "Alice", Email: "alice@example.com"}, }  func userHandler(w http.ResponseWriter, r *http.Request) { 	switch r.Method { 	case "GET": 		id := 1 // 简化示例，实际应从 URL path 提取 		if u, ok := users[id]; ok { 			w.Header().Set("Content-Type", "application/json") 			json.NewEncoder(w).Encode(u) 		} else { 			w.WriteHeader(http.StatusNotFound) 			json.NewEncoder(w).Encode(map[string]string{"error": "user not found"}) 		} 	case "POST": 		var u User 		if err := json.NewDecoder(r.Body).Decode(&u); err != nil { 			w.WriteHeader(http.StatusbadRequest) 			json.NewEncoder(w).Encode(map[string]string{"error": "invalid JSON"}) 			return 		} 		if u.Name == "" || u.Email == "" { 			w.WriteHeader(http.StatusBadRequest) 			json.NewEncoder(w).Encode(map[string]string{"error": "name and email required"}) 			return 		} 		users[u.ID] = u 		w.WriteHeader(http.StatusCreated) 		json.NewEncoder(w).Encode(u) 	default: 		w.WriteHeader(http.StatusMethodNotAllowed) 		json.NewEncoder(w).Encode(map[string]string{"error": "method not allowed"}) 	} }  func main() { 	http.HandleFunc("/users", userHandler) 	log.Println("Server starting on :8080") 	log.Fatal(http.ListenAndServe(":8080", nil)) }

真正难的不是写完这个例子，而是后续加中间件（日志、鉴权）、处理并发读写 map、支持路径参数（如 /users/{id}）、做 graceful shutdown —— 这些不写在基础例子里，但上线第一天就会撞上。