Go语言中高效处理JSON POST请求的实践指南

// 错误的示例代码（避免在生产环境中使用）
package main

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

type test_struct struct {
    Test string
}

func test(rw http.ResponseWriter, req *http.Request) {
    req.ParseForm() // 错误：JSON数据不应被解析为表单
    log.Println(req.Form) // LOG: map[{"test": "that"}:[]]
    var t test_struct
    for key, _ := range req.Form { // 错误：将JSON字符串作为表单键处理
        log.Println(key) // LOG: {"test": "that"}
        err := json.Unmarshal([]byte(key), &t) // 错误：从表单键中反序列化JSON
        if err != nil {
            log.Println(err.Error())
        }
    }
    log.Println(t.Test) // LOG: that
}

func main() {
    http.HandleFunc("/test", test)
    log.Fatal(http.ListenAndServe(":8082", nil))
}

package main

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

// 定义用于接收JSON数据的结构体
type test_struct struct {
    Test string `json:"test"` // 使用json tag确保字段名与JSON键匹配
}

// 处理/test路径的HTTP请求
func test(rw http.ResponseWriter, req *http.Request) {
    // 确保请求方法是POST
    if req.Method != http.MethodPost {
        http.Error(rw, "Method Not Allowed", http.StatusMethodNotAllowed)
        return
    }

    // defer关闭请求体，确保资源释放
    // req.Body 是一个 io.ReadCloser，使用后应关闭
    defer req.Body.Close()

    // 创建一个json.Decoder来从请求体中读取JSON
    decoder := json.NewDecoder(req.Body)
    var t test_struct

    // 解码JSON数据到结构体t
    err := decoder.Decode(&t)
    if err != nil {
        // 处理JSON解析错误，例如格式不正确或EOF
        log.Printf("Error decoding JSON: %v", err)
        http.Error(rw, "Bad Request: Invalid JSON format", http.StatusBadRequest)
        return
    }

    // 成功解析后，打印结构体字段
    log.Printf("Received Test value: %s", t.Test)

    // 返回成功响应
    rw.Header().Set("Content-Type", "application/json")
    rw.WriteHeader(http.StatusOK)
    // 可以将响应数据编码为JSON返回给客户端
    json.NewEncoder(rw).Encode(map[string]string{"status": "success", "message": "data received"})
}

func main() {
    http.HandleFunc("/test", test)
    log.Printf("Server starting on :8082")
    log.Fatal(http.ListenAndServe(":8082", nil))
}

curl -X POST -H "Content-Type: application/json" -d '{"test": "that"}' http://localhost:8082/test