f586a0b19e
P1: 31 widget 旧纸感令牌批量迁移到 shadcn 标准（1104 次替换） - bg-paper→bg-background / bg-surface→bg-card / text-ink→text-foreground - 保留 button.tsx 中 bg-accent（shadcn 标准 hover 语义令牌） P2: v2.0 新增组件单元测试补齐（5 文件 81 用例） - permission-bitmap: 24 用例（含 GRADE_READ 重复去重） - route-permissions: 26 用例（4 张表优先级 + AND/OR 语义） - notify: 12 用例（sonner toast 双重性质 vi.hoisted mock） - use-error-report: 9 用例（jsdom Blob vi.stubGlobal mock） - plugin-boundary: 10 用例（错误边界 + 骨架变体） P3: 错误上报端点生产替换（后端 /api/v1/log） - api-gateway: internal/log/handler.go（slog 结构化日志，64KB 限制，204 返回） - main.go: 注册 POST /api/v1/log 路由 - useErrorReport: 环境感知端点（prod→/api/v1/log，dev→/api/log） P4: E2E 测试（3 文件 30 用例） - streaming: 4 用例（React 19 use() + Suspense，act 包裹 render） - error-boundaries: 6 用例（三级错误边界层级 L1/L2/L3） - security-boundaries: 20 用例（L1 角色门禁 + L2 权限点 + L3 数据范围） - vitest setup: IS_REACT_ACT_ENVIRONMENT + jest-dom matchers 验证：typecheck 0 错误 / lint 0 错误 / build 6 路由 / 206 测试全部通过
111 lines
3.5 KiB
Go
111 lines
3.5 KiB
Go
// Package log 提供前端错误上报接收端点。
|
||
//
|
||
// 路由：POST /api/v1/log
|
||
// 职责：
|
||
// - 接收前端 useErrorReport hook 通过 sendBeacon/fetch keepalive 上报的错误
|
||
// - 使用 slog 结构化日志记录（后续可接入 OTel/Sentry）
|
||
// - 返回 204 No Content（sendBeacon 不需要响应体）
|
||
//
|
||
// 安全：
|
||
// - 已通过 api-gateway 的 JWT 鉴权中间件
|
||
// - 请求体大小限制 64KB（错误日志不需要大 body）
|
||
// - 限流由全局 RateLimit 中间件保障
|
||
//
|
||
// 关联：portal-shell README v2.0 §5.4 三级错误处理
|
||
package log
|
||
|
||
import (
|
||
"encoding/json"
|
||
"io"
|
||
"log/slog"
|
||
"net/http"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
)
|
||
|
||
// maxLogBodySize 日志请求体上限：64KB
|
||
const maxLogBodySize int64 = 64 * 1024
|
||
|
||
// ErrorReportPayload 前端错误上报 payload 结构
|
||
// 对齐 packages/hooks/src/use-error-report.ts 的 ErrorReportPayload
|
||
type ErrorReportPayload struct {
|
||
Level string `json:"level"` // "error" | "warning"
|
||
Message string `json:"message"` // 错误消息
|
||
Stack string `json:"stack,omitempty"` // 调用栈
|
||
Digest string `json:"digest,omitempty"` // Next.js 错误摘要
|
||
Path string `json:"path"` // window.location.pathname
|
||
UserAgent string `json:"userAgent"` // navigator.userAgent
|
||
Timestamp string `json:"timestamp"` // ISO 8601
|
||
PluginID string `json:"pluginId,omitempty"` // 插件标识
|
||
UserID string `json:"userId,omitempty"` // 用户 ID
|
||
Context map[string]interface{} `json:"context,omitempty"` // 额外上下文
|
||
}
|
||
|
||
// HandleReport 接收前端错误上报。
|
||
//
|
||
// POST /api/v1/log
|
||
// Request Body: ErrorReportPayload (JSON)
|
||
// Response: 204 No Content
|
||
//
|
||
// 容错策略：
|
||
// - JSON 解析失败 → 400 + 错误消息
|
||
// - 其他错误 → 204（前端上报失败静默降级，不应阻塞）
|
||
func HandleReport(c *gin.Context) {
|
||
// 限制请求体大小
|
||
c.Request.Body = http.MaxBytesReader(c.Writer, c.Request.Body, maxLogBodySize)
|
||
|
||
body, err := io.ReadAll(c.Request.Body)
|
||
if err != nil {
|
||
slog.Warn("log report: read body failed",
|
||
"error", err,
|
||
"request_id", c.GetString("request_id"),
|
||
)
|
||
c.Status(http.StatusNoContent)
|
||
return
|
||
}
|
||
|
||
var payload ErrorReportPayload
|
||
if err := json.Unmarshal(body, &payload); err != nil {
|
||
slog.Warn("log report: invalid JSON",
|
||
"error", err,
|
||
"request_id", c.GetString("request_id"),
|
||
"body_size", len(body),
|
||
)
|
||
c.JSON(http.StatusBadRequest, gin.H{
|
||
"error": "invalid JSON payload",
|
||
})
|
||
return
|
||
}
|
||
|
||
// 结构化日志记录（后续可替换为 OTel/Sentry exporter）
|
||
slog.LogAttrs(c.Request.Context(), toSlogLevel(payload.Level),
|
||
payload.Message,
|
||
slog.String("logger", "frontend"),
|
||
slog.String("digest", payload.Digest),
|
||
slog.String("path", payload.Path),
|
||
slog.String("plugin_id", payload.PluginID),
|
||
slog.String("user_id", payload.UserID),
|
||
slog.String("user_agent", payload.UserAgent),
|
||
slog.String("timestamp", payload.Timestamp),
|
||
slog.String("stack", payload.Stack),
|
||
slog.Any("context", payload.Context),
|
||
slog.String("request_id", c.GetString("request_id")),
|
||
)
|
||
|
||
c.Status(http.StatusNoContent)
|
||
}
|
||
|
||
// toSlogLevel 将前端 level 映射到 slog.Level
|
||
func toSlogLevel(level string) slog.Level {
|
||
switch level {
|
||
case "error":
|
||
return slog.LevelError
|
||
case "warning":
|
||
return slog.LevelWarn
|
||
case "info":
|
||
return slog.LevelInfo
|
||
default:
|
||
return slog.LevelError
|
||
}
|
||
}
|