阶段2(上):后端专题 Go/Gin/PostgreSQL/MySQL/Redis/MQ/gRPC 的课程、企业场景、面试题和可运行示例

This commit is contained in:
Shikui Wang committed 2026-10-23 15:24:57 +08:00
1 parent 0bae9916a9
commit 5eb67c5d08
65 files changed
+6457 -77

No files matched your search

@@ -0,0 +1,68 @@
package unifiedapi
import (
"encoding/json"
"io"
"log/slog"
"net/http"
"net/http/httptest"
"strings"
"testing"
"github.com/gin-gonic/gin"
)
func do(t *testing.T, r http.Handler, method, path, body string, hdr map[string]string) (int, Body, http.Header) {
t.Helper()
req := httptest.NewRequest(method, path, strings.NewReader(body))
req.Header.Set("Content-Type", "application/json")
for k, v := range hdr {
req.Header.Set(k, v)
}
w := httptest.NewRecorder()
r.ServeHTTP(w, req)
var b Body
if err := json.Unmarshal(w.Body.Bytes(), &b); err != nil {
t.Fatalf("响应不是统一格式:%s", w.Body.String())
}
return w.Code, b, w.Header()
}
func TestUnifiedResponses(t *testing.T) {
gin.SetMode(gin.TestMode)
r := New(slog.New(slog.NewTextHandler(io.Discard, nil)))
cases := []struct {
name, method, path, body string
status, code int
msgContains string
}{
{"创建成功", "POST", "/api/tasks", `{"title":"写周报","priority":"high"}`, 201, 0, "ok"},
{"必填校验", "POST", "/api/tasks", `{"title":""}`, 400, 40000, "title 不能为空"},
{"枚举校验", "POST", "/api/tasks", `{"title":"a","priority":"urgent"}`, 400, 40000, "priority 只能是 low normal high 之一"},
{"JSON 格式错误", "POST", "/api/tasks", `{"title":`, 400, 40000, "请求体格式错误"},
{"查询存在", "GET", "/api/tasks/1", "", 200, 0, "ok"},
{"查询不存在", "GET", "/api/tasks/999", "", 404, 40400, "资源不存在"},
{"panic 兜底", "GET", "/api/boom", "", 500, 50000, "服务器开小差"},
{"内部错误不泄漏细节", "GET", "/api/db-error", "", 500, 50000, "服务器开小差"},
}
for _, c := range cases {
t.Run(c.name, func(t *testing.T) {
status, b, h := do(t, r, c.method, c.path, c.body, nil)
if status != c.status || b.Code != c.code || !strings.Contains(b.Message, c.msgContains) {
t.Fatalf("got %d %+v", status, b)
}
if b.RequestID == "" || h.Get("X-Request-ID") != b.RequestID {
t.Fatalf("缺少请求 ID:%+v", b)
}
if strings.Contains(b.Message, "secret") || strings.Contains(b.Message, "relation") {
t.Fatal("内部错误细节泄漏给了用户")
}
})
}
_, b, _ := do(t, r, "GET", "/api/tasks/1", "", map[string]string{"X-Request-ID": "trace-123"})
if b.RequestID != "trace-123" {
t.Fatalf("应沿用客户端的请求 ID,得到 %q", b.RequestID)
}
}