该技能面向使用 Go 与 Gin 构建生产级 REST API 的日常开发场景,适用于新建 Go HTTP 服务、为 Gin 应用增加路由、处理器或中间件,以及绑定并校验 JSON、查询和 URI 参数。内容覆盖约八成常用模式:服务器搭建、路由分组、请求绑定、响应格式化和错误处理。
项目结构建议使用 cmd/api/main.go 作为入口,internal/ 放处理器、服务、仓储和领域模型,pkg/ 放可复用中间件。生产环境使用 gin.New() 加显式中间件而非 gin.Default(),并配置可信代理、日志与恢复中间件,通过 http.Server 的 ReadHeaderTimeout、ReadTimeout、WriteTimeout、IdleTimeout 及信号捕获实现优雅关闭。
主要能力包括:领域模型与请求 DTO 分离;薄处理器只做绑定、调用服务和返回响应;使用 ShouldBindJSON、ShouldBindQuery、ShouldBindURI 绑定输入并配合 binding 标签校验;绑定后对字符串做 TrimSpace、HTML 转义等清理,文件上传用 filepath.Base 处理文件名;集中式 AppError 将领域错误映射为 401、403、404、409、422 等状态码,5xx 只记录日志不向客户端暴露原始错误;在 goroutine 中使用 c.Copy() 保证上下文安全。
使用方式即按上述模式组织代码与路由,公开路由与受保护路由分组,受保护路由接入 JWT 中间件(见 golang-gin-auth 技能),数据库装配见 golang-gin-database,测试见 golang-gin-testing,部署见 golang-gin-deploy。更深入的路由、中间件、错误处理、WebSocket、限流细节分别见对应 references 文件。限制方面:本技能未说明安装命令、收费、价格或具体效果,相关资料暂未提供;示例中的 AppError 为简化版,规范错误模式需参考 golang-gin-clean-arch。