S1-B D5-P1: 搬运 api/http/v1(19 handler+测试)+cmd/gateway+cmd/consumer——后端全链装配通(gateway 二进制 65.9MB 编译成功,build/vet/api -race 50.3% 全绿);适配=channel.{LinkStatus,Receipt,BatchAck}→pool.*(D2.5-P2 移位);scheduler/business 空壳按裁决不搬

This commit is contained in:
2026-11-13 16:58:09 +08:00
parent 39e8da6417
commit 5c8393ea3f
43 changed files with 8064 additions and 2 deletions
+115
View File
@@ -0,0 +1,115 @@
// feerror_handler.go Day 53(runbook §6.4 P0):前端错误上报端点。
// - POST /fe-errors 上报(public:登录页 JS 错误/网络层 5xx 也须可达;引擎级 IP 限流兜底)
// - GET /fe-errors 排障查询(admin/ops;kind 过滤+分页,id DESC 最新在前)
//
// 采集侧:web/src/utils/error-reporter.ts(window.onerror/unhandledrejection)+
// request.ts 响应拦截器(5xx/网络错误,带 X-Trace-Id 关联后端日志链)。
package v1
import (
"strings"
"github.com/gin-gonic/gin"
"gorm.io/gorm"
"go-sms/internal/middleware"
"go-sms/internal/model/entity"
"go-sms/internal/pkg/response"
)
// feErrorPayload 上报体(前端单条;批量由多次上报承担,保持接口最小)。
type feErrorPayload struct {
Kind string `json:"kind"` // js|http|unhandled
PageURL string `json:"page_url"` // window.location.href
Message string `json:"message"`
Stack string `json:"stack"`
UA string `json:"ua"` // navigator.userAgent
TraceID string `json:"trace_id"` // 请求 X-Trace-Id(HTTP 类错误关联后端)
}
// feErrorFieldMax 字段截断上限(与实体列宽一致,防超长栈打爆 INSERT)。
var feErrorFieldMax = map[string]int{"page_url": 512, "message": 1024, "stack": 8192, "ua": 512, "trace_id": 64}
func feTrunc(field, s string) string {
if max, ok := feErrorFieldMax[field]; ok && len(s) > max {
return s[:max]
}
return s
}
// feKindAllowed 上报类型白名单(未知值归一 js,防标签基数滥用)。
func feKindAllowed(k string) string {
switch k {
case "http", "unhandled":
return k
default:
return "js"
}
}
type feErrorHandler struct{ db *gorm.DB }
// registerFeErrorRoutes 挂载前端错误上报路由。
func registerFeErrorRoutes(rg *gin.RouterGroup, protected *gin.RouterGroup, db *gorm.DB, perm middleware.PermissionChecker) {
if db == nil {
return
}
h := &feErrorHandler{db: db}
rg.POST("/fe-errors", h.report)
protected.GET("/fe-errors",
middleware.RequirePermission(perm, "system", "read"), h.list)
}
// report POST /fe-errors:落库即成功(上报通道自身永不抛业务错,防前端重试风暴)。
func (h *feErrorHandler) report(c *gin.Context) {
var p feErrorPayload
if err := c.ShouldBindJSON(&p); err != nil {
// 畸形体也按成功应答:错误上报是尽力而为通道,客户端无需重试
response.Success(c, nil)
return
}
row := entity.FeErrorLog{
Kind: feKindAllowed(p.Kind),
PageURL: feTrunc("page_url", strings.TrimSpace(p.PageURL)),
Message: feTrunc("message", strings.TrimSpace(p.Message)),
Stack: feTrunc("stack", p.Stack),
UA: feTrunc("ua", p.UA),
TraceID: feTrunc("trace_id", strings.TrimSpace(p.TraceID)),
}
if row.Message == "" && row.Stack == "" {
response.Success(c, nil) // 空上报不落库
return
}
if err := h.db.WithContext(c.Request.Context()).Create(&row).Error; err != nil {
// 落库失败也不回错误码:前端侧静默(runbook:上报失败不阻塞业务)
_ = c.Error(err)
}
response.Success(c, nil)
}
// list GET /fe-errors:排障查询(kind 过滤+分页,id DESC)。
func (h *feErrorHandler) list(c *gin.Context) {
page := atoiDefault(c.Query("page"), 1)
pageSize := atoiDefault(c.Query("page_size"), 20)
if pageSize > 100 {
pageSize = 100
}
q := h.db.WithContext(c.Request.Context()).Model(&entity.FeErrorLog{})
if kind := strings.TrimSpace(c.Query("kind")); kind != "" {
q = q.Where("kind = ?", kind)
}
if tid := strings.TrimSpace(c.Query("trace_id")); tid != "" {
q = q.Where("trace_id = ?", tid)
}
var total int64
if err := q.Count(&total).Error; err != nil {
bizResp(c, err)
return
}
var rows []entity.FeErrorLog
if err := q.Order("id DESC").Offset((page - 1) * pageSize).Limit(pageSize).Find(&rows).Error; err != nil {
bizResp(c, err)
return
}
response.Success(c, gin.H{"list": rows, "total": total})
}