在Golang中测试接口返回结果需用httptest模拟请求并捕获响应，再通过json.Unmarshal解析JSON，结合testing或testify/assert断言状态码、字段值及结构；推荐使用assert.JSONEq比对JSON内容。
在 Golang 中测试接口返回结果，通常是在编写 HTTP 服务时对 API 接口进行单元测试或集成测试。核心目标是验证接口返回的状态码、响应体、数据结构等是否符合预期。常用的方法包括使用 net/http/httptest 模拟请求，结合 testing 包进行断言。由于 Go 没有内置的断言库，开发者常借助第三方库或手动判断 + assert 风格函数来完成。
1. 使用标准库 testing + httptest 测试接口
Go 标准库提供了 net/http/httptest 来模拟 HTTP 请求和响应，适合测试基于 net/http 的 Web 接口。
示例：测试一个返回 JSON 的 GET 接口假设有一个简单接口：
func handler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
w.WriteHeader(http.StatusOK)
json.NewEncoder(w).Encode(map[string]string{"message": "hello", "status": "ok"})
}
对应的测试代码：
立即学习“go语言免费学习笔记（深入）”；
func TestHandler(t *testing.T) {
req := httptest.NewRequest("GET", "/", nil)
w := httptest.NewRecorder()
handler(w, req)
// 断言状态码
if w.Code != http.StatusOK {
t.Errorf("期望状态码 %d，实际得到 %d", http.StatusOK, w.Code)
}
// 读取响应体
var resp map[string]string
err := json.Unmarshal(w.Body.Bytes(), &resp)
if err != nil {
t.Fatalf("解析 JSON 失败: %v", err)
}
// 断言字段值
if resp["message"] != "hello" {
t.Errorf("期望 message 为 hello，实际为 %s", resp["message"])
}
if resp["status"] != "ok" {
t.Errorf("期望 status 为 ok，实际为 %s", resp["status"])
}
}
2. 使用 testify/assert 进行更简洁的断言
手动写 if 判断容易冗长，推荐使用 github.com/stretchr/testify/assert 库简化断言逻辑。
安装 testify：go get github.com/stretchr/testify使用 assert 重写上述测试：
import (
"net/http"
"net/http/httptest"
"encoding/json"
"testing"
"github.com/stretchr/testify/assert"
)
func TestHandlerWithAssert(t *testing.T) {
req := httptest.NewRequest("GET", "/", nil)
w := httptest.NewRecorder()
handler(w, req)
// 断言状态码
assert.Equal(t, http.StatusOK, w.Code)
var resp map[string]string
err := json.Unmarshal(w.Body.Bytes(), &resp)
assert.NoError(t, err)
// 断言响应内容
assert.Equal(t, "hello", resp["message"])
assert.Equal(t, "ok", resp["status"])
}
testify 提供了丰富的断言方法如 assert.Equal、assert.Contains、assert.JSONEq 等，提升可读性和开发效率。
3. 对复杂结构体或 JSON 做深度断言
当接口返回的是嵌套结构体或数组时，可以定义结构体并用 json.Unmarshal 解码后逐字段断言。
示例：返回用户列表type User struct {
ID int `json:"id"`
Name string `json:"name"`
}
func usersHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode([]User{{ID: 1, Name: "Alice"}, {ID: 2, Name: "Bob"}})
}
测试代码：
func TestUsersHandler(t *testing.T) {
req := httptest.NewRequest("GET", "/users", nil)
w := httptest.NewRecorder()
usersHandler(w, req)
assert.Equal(t, http.StatusOK, w.Code)
var users []User
err := json.Unmarshal(w.Body.Bytes(), &users)
assert.NoError(t, err)
assert.Len(t, users, 2)
assert.Equal(t, "Alice", users[0].Name)
assert.Equal(t, 2, users[1].ID)
}
4. 使用 assert.JSONEq 忽略格式差异比对 JSON
如果只关心 JSON 内容而不在意顺序或空格，可用 assert.JSONEq 直接比对原始 JSON 字符串。
expected := `{"status": "ok", "message": "hello"}`
assert.JSONEq(t, expected, w.Body.String())
这在响应结构较复杂但不需要结构化解析时非常实用。
基本上就这些。测试接口返回结果的关键是：模拟请求、捕获响应、解析内容、合理断言。配合 testify 可大幅简化流程，提高测试可维护性。
