docs: 同步更新请求日志中间件文档(请求参数 + 响应数据记录策略)

- system-architecture.md 8.6: 完整记录策略表、状态码分级、日志输出示例
- phase1 实施计划 Task 2: 更新 logger 中间件描述

Made-with: Cursor
This commit is contained in:
bujinyuan
2026-02-28 15:51:27 +08:00
parent 8a023dfd87
commit 99c2f4f86a
2 changed files with 87 additions and 4 deletions

View File

@@ -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 日志含堆栈信息)。