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:
@@ -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})
|
||||
}
|
||||
Reference in New Issue
Block a user