如何使用 Go 语言正确响应 fetch API 请求-Golang-PHP中文网

如何使用 Go 语言正确响应 fetch API 请求

本文详解如何在 Go 后端（基于 httprouter）中正确构造并发送 JSON 或纯文本响应，以匹配前端 fetch 的 .json() 解析需求，避免因响应格式不匹配导致的解析错误。

本文详解如何在 go 后端（基于 httprouter）中正确构造并发送 json 或纯文本响应，以匹配前端 fetch 的 `.json()` 解析需求，避免因响应格式不匹配导致的解析错误。

在使用 fetch 发起 POST 请求时，前端默认调用 .json() 方法解析响应体（如 response.json()），这意味着后端必须返回合法、可解析的 JSON 数据，且需设置正确的 Content-Type: application/json 响应头；否则将触发 SyntaxError: Unexpected token 等解析异常。

你当前的 Go 处理函数中使用了 fmt.Fprintf(rw, "success")，这虽能向客户端写入字符串，但存在两个关键问题：

未设置响应头 → 浏览器/fetch 无法识别内容类型，.json() 尝试解析纯文本 "success" 会失败；
返回非 JSON 格式 → "success" 是字符串字面量，不是有效 JSON（合法 JSON 字符串应为 "\"success\"", 而更推荐结构化对象如 {"status": "success"}）。

✅ 正确做法是：

使用 json.NewEncoder(rw).Encode(v) 安全序列化任意 Go 值为 JSON；
提前设置响应头：rw.Header().Set("Content-Type", "application/json")；
可选：设置 HTTP 状态码（如 rw.WriteHeader(http.StatusOK)）。

以下是修正后的完整处理函数示例：

import (
    "encoding/json"
    "net/http"
    // ... 其他导入（如 httprouter）
)

func Validate(rw http.ResponseWriter, req *http.Request, _ httprouter.Params) {
    // 解析请求体
    decoder := json.NewDecoder(req.Body)
    var creds credentials
    if err := decoder.Decode(&creds); err != nil {
        rw.WriteHeader(http.StatusBadRequest)
        json.NewEncoder(rw).Encode(map[string]string{"error": "invalid JSON payload"})
        return
    }

    // 业务逻辑（验证邮箱密码等）
    // ...

    // ✅ 正确返回 JSON 响应
    rw.Header().Set("Content-Type", "application/json")
    rw.WriteHeader(http.StatusOK) // 显式设置状态码更清晰
    json.NewEncoder(rw).Encode(map[string]string{"status": "success", "message": "validation passed"})
}

⚠️ 注意事项：

不要使用 fmt.Println() 或 fmt.Fprintf(rw, ...) 直接输出 JSON 字符串 —— 易出错且无法自动转义；json.Encoder 保证输出严格符合 JSON 规范；
务必在 Encode() 前设置 Content-Type 头，否则 fetch 可能按 text/plain 解析，导致 .json() 失败；
若需返回简单字符串（如仅 "success"），仍应封装为 JSON 字符串：json.NewEncoder(rw).Encode("success")（Go 会自动输出 "success"）；
错误处理时也应返回 JSON 响应（如上例），保持前后端约定一致，便于前端统一捕获 error 字段。