feat(server): 实现统一响应格式和错误码

- 添加 server/go.mod,模块路径为 github.com/1024XEngineer/xinfra/server
- 实现 response.go 统一 JSON 响应结构:
  - 响应信封:{ code, message, data, details }
  - 业务错误码 (10001-20002) 与 MVP 规范一致
  - 便捷函数:Success, Error, BadRequest, Unauthorized 等
  - 分页响应支持,包含 total 和 items
- 添加 recovery 中间件捕获 panic 并返回 500 错误
- 添加 logger 中间件记录请求日志

为所有后端处理器建立统一的 API 响应基础,与前端期望的格式保持一致。
This commit is contained in:
2026-07-15 10:44:32 +08:00
parent 5879103de9
commit 4f1df02f53
4 changed files with 215 additions and 0 deletions
+38
View File
@@ -0,0 +1,38 @@
package middleware
import (
"log"
"time"
"github.com/gin-gonic/gin"
)
// Logger 返回请求日志中间件
// 记录请求方法、路径、状态码、耗时、客户端 IP
func Logger() gin.HandlerFunc {
return func(c *gin.Context) {
// 请求开始时间
startTime := time.Now()
// 处理请求
c.Next()
// 计算耗时
duration := time.Since(startTime)
// 获取请求信息
method := c.Request.Method
path := c.Request.URL.Path
statusCode := c.Writer.Status()
clientIP := c.ClientIP()
// 记录日志
log.Printf("[REQUEST] %s %s | %d | %v | %s",
method,
path,
statusCode,
duration,
clientIP,
)
}
}
+29
View File
@@ -0,0 +1,29 @@
package middleware
import (
"log"
"net/http"
"runtime/debug"
"github.com/1024XEngineer/xinfra/server/internal/handler"
"github.com/gin-gonic/gin"
)
// Recovery 返回 panic 恢复中间件
// 捕获请求处理过程中的 panic,返回 500 错误而不是崩溃
func Recovery() gin.HandlerFunc {
return func(c *gin.Context) {
defer func() {
if err := recover(); err != nil {
// 记录 panic 堆栈信息
log.Printf("[PANIC] %v\n%s", err, debug.Stack())
// 返回 500 错误
handler.InternalError(c, "服务器内部错误")
c.Abort()
}
}()
c.Next()
}
}