推荐采用经典的分层架构:API层 → Service层 → Repository层 → Domain层 → Data Access。每层职责单一、依赖方向明确,确保业务逻辑与技术实现解耦。
以用户注册为例:API接收请求 → Service校验参数、调用Domain校验规则 → Repository执行数据库写入 → 返回结果。任一层变更不影响其他层。
关键说明:
• internal/ 目录确保模块仅能被本项目导入,防止外部滥用
• cmd/ 包含可执行程序入口,每个子目录对应一个二进制文件
• pkg/ 用于存放可被外部项目依赖的共享代码(如工具库)
• 配置文件应支持环境覆盖(dev/stage/prod)
• 所有业务代码必须在 internal/ 下,避免误导出
• 快速验证业务逻辑,采用单体架构
• 使用 Gin/Echo 框架搭建基础 API
• 内存数据库(如 boltdb)加速开发
• 日志仅输出到控制台
• 无自动化测试
• 实施标准化目录结构
• 引入数据库迁移工具(golang-migrate)
• 配置文件分离(config.yaml + env overlay)
• 添加单元测试(覆盖率 ≥60%)
• 集成日志系统(Zap + 文件输出)
• 性能压测(go-benchmark + vegeta)
• 优化数据库查询(索引、连接池)
• 实现缓存策略(Redis 分布式缓存)
• 引入熔断与限流(go-kit/kit/circuitbreaker)
• 监控指标接入(Prometheus + Grafana)
• 微服务拆分(gRPC + Service Mesh)
• 分布式追踪(OpenTelemetry)
• CI/CD 自动化(GitHub Actions + ArgoCD)
• 安全加固(JWT 认证、SQL 注入防护)
• 自动扩缩容(Kubernetes HPA)
go test -coverprofile=coverage.out 查看覆盖率报告开发者 push 代码至主分支或 Merge Request,触发 CI 流水线
安装依赖 → 运行单元测试 → 代码检查(gofmt/golangci-lint)
构建多阶段 Docker 镜像(轻量基础镜像 + 最小化产物)
自动部署至测试环境 → 运行集成测试 → 环境健康检查
逐步替换旧版本(如 10% → 50% → 100%),实时监控指标
若关键指标异常(错误率↑、延迟↑),立即回滚至稳定版本
SELECT * FROM users WHERE id = ` + id + ` → 易受 SQL 注入攻击go mod tidy 清理未使用依赖go list -m -versions 检查依赖版本