Golang如何开发基础的API服务_Golang API服务开发实践_技术教程

使用Go的net/http库可快速搭建API服务，通过http.HandleFunc注册路由并处理请求；2. 实现RESTful接口需根据r.Method判断操作类型，支持GET、POST等方法对资源进行增查改删；3. 可定义中间件实现日志记录和统一错误处理，提升服务可观测性与一致性；4. 建议初期使用标准库理解底层原理，后续按需组织代码结构或引入Gin等框架扩展功能。

用Golang开发基础的API服务并不复杂，核心在于理解HTTP服务的基本结构、路由控制和数据处理方式。Go语言标准库已经提供了足够强大的支持，无需依赖框架也能快速搭建一个稳定高效的API服务。

使用net/http搭建HTTP服务器

Go的标准库net/http是构建API服务的基础。通过它，可以轻松注册路由和处理请求。

一个最简单的HTTP服务如下：

package main

import (
    "encoding/json"
    "net/http"
)

func helloHandler(w http.ResponseWriter, r *http.Request) {
    response := map[string]string{"message": "Hello, API!"}
    w.Header().Set("Content-Type", "application/json")
    json.NewEncoder(w).Encode(response)
}

func main() {
    http.HandleFunc("/api/hello", helloHandler)
    http.ListenAndServe(":8080", nil)
}

这段代码启动了一个监听8080端口的服务，访问/api/hello会返回JSON格式的响应。注意设置Content-Type头，确保客户端正确解析。

实现RESTful风格的路由

实际项目中，通常需要支持多种HTTP方法（GET、POST、PUT、DELETE）来操作资源。可以通过判断r.Method来区分请求类型。

例如，模拟一个用户管理接口：

func userHandler(w http.ResponseWriter, r *http.Request) {
    switch r.Method {
    case "GET":
        // 返回用户列表
        users := []string{"Alice", "Bob"}
        json.NewEncoder(w).Encode(users)
    case "POST":
        // 创建新用户
        var input struct{ Name string }
        json.NewDecoder(r.Body).Decode(&input)
        w.WriteHeader(http.StatusCreated)
        json.NewEncoder(w).Encode(map[string]string{"status": "created", "name": input.Name})
    default:
        http.Error(w, "Method not allowed", http.StatusMethodNotAllowed)
    }
}

将该处理器注册到/api/users路径，即可实现基本的增查功能。根据需求扩展逻辑即可。

中间件与错误处理

为了增强服务的可观测性和健壮性，可以引入简单的中间件机制。比如日志记录和统一错误响应。

定义一个日志中间件：

func loggingMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        log.Printf("%s %s %s", r.RemoteAddr, r.Method, r.URL)
        next(w, r)
    }
}

使用时包装处理器：

http.HandleFunc("/api/users", loggingMiddleware(userHandler))

对于错误处理，建议封装一个通用函数：

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

在参数校验失败或内部出错时调用，保持API响应格式一致。