docs: 同步更新请求日志中间件文档(请求参数 + 响应数据记录策略)
- system-architecture.md 8.6: 完整记录策略表、状态码分级、日志输出示例 - phase1 实施计划 Task 2: 更新 logger 中间件描述 Made-with: Cursor
This commit is contained in:
@@ -253,8 +253,14 @@ type Response struct {
|
||||
|
||||
创建 `pkg/middleware/logger.go` — **请求日志中间件**:
|
||||
- 记录每个请求的完整信息:方法、路径、状态码、耗时、IP、User-Agent
|
||||
- **请求参数记录**:Query 参数 + Request Body 在 INFO 级别始终记录(所有环境生效)
|
||||
- 文件上传自动跳过,仅标记 `[file upload]`
|
||||
- 敏感路径(登录/注册/改密码)自动脱敏 password 字段
|
||||
- Body 超过 4KB 自动截断
|
||||
- **响应数据记录**:正常响应 DEBUG 级别记录,错误响应(4xx/5xx)在 WARN/ERROR 也记录
|
||||
- 响应 Body 最大记录 2KB
|
||||
- 自动携带 trace_id
|
||||
- 慢请求告警(>500ms 记录 WARN)
|
||||
- 状态码分级:5xx→ERROR / 4xx→WARN / 慢请求(>500ms)→WARN / 正常→INFO
|
||||
|
||||
创建 `pkg/middleware/cors.go` — CORS 跨域中间件。
|
||||
创建 `pkg/middleware/recovery.go` — Panic 恢复中间件(捕获 panic 后记录 ERROR 日志含堆栈信息)。
|
||||
|
||||
Reference in New Issue
Block a user