yangy
b2c11adeba
- 新增BrandCache与ModelCache，实现多级缓存和TTL管理 - 引入缓存预热机制，启动时自动加载品牌与型号数据 - 实现缓存穿透防护和数据库降级策略，提升服务稳定性 - 优化缓存键命名和数据序列化策略，增强管理便捷性 - 数据访问层新增缓存感知查询，品牌与型号仓库支持缓存优先 - 调整整体架构，增强组件解耦及依赖注入链路清晰度 - 提供详细的性能优化建议和故障排查指南 - 补充监控指标说明，便于后续运维与监控扩展
app-api
基于 Gin 的 Go HTTP API 脚手架。
项目结构
app-api/
├── cmd/server/ # 程序入口
├── internal/
│ ├── config/ # 配置加载
│ ├── handler/ # HTTP 处理器
│ ├── middleware/ # 中间件（日志、CORS、Request ID）
│ ├── response/ # 统一 JSON 响应
│ └── router/ # 路由注册
└── pkg/logger/ # 可复用日志封装
快速开始
环境要求
- Go 1.22+
安装依赖
go mod tidy
配置（可选）
复制环境变量示例：
cp .env.example .env
| 变量 | 默认值 | 说明 |
|---|---|---|
APP_ENV |
development |
运行环境 |
APP_HOST |
0.0.0.0 |
监听地址 |
APP_PORT |
8080 |
监听端口 |
GIN_MODE |
debug |
Gin 运行模式 |
数据库
根据 APP_ENV 自动选择 MySQL 配置；也可通过 DATABASE_* 环境变量完全覆盖。
| 环境 | APP_ENV |
默认连接 |
|---|---|---|
| 开发 | development |
localhost:3306/audio，用户 root，密码 root123 |
| 正式 | production |
AWS RDS database-1.chmuueamo72p.eu-central-1.rds.amazonaws.com:3306/audio |
正式环境密码必须通过环境变量 DATABASE_PASSWORD 提供（不要写入代码仓库）。可参考 .env.production.example。
开发环境可在 .env 中覆盖：
DATABASE_HOST=localhost
DATABASE_PORT=3306
DATABASE_NAME=audio
DATABASE_USER=root
DATABASE_PASSWORD=root123
正式环境启动示例（PowerShell）：
$env:APP_ENV = "production"
$env:DATABASE_PASSWORD = "your-production-password"
go run ./cmd/server
运行
make run
# 或
go run ./cmd/server
健康检查
curl http://localhost:8080/api/v1/health
响应示例：
{
"code": 0,
"message": "ok",
"data": {
"status": "up"
}
}
品牌列表
# 查询全部
curl "http://localhost:8080/audio/getBrand"
# 按名称模糊查询
curl "http://localhost:8080/audio/getBrand?brandName=sony"
添加新接口
- 在
internal/handler/新建 handler - 在
internal/router/router.go的/api/v1分组下注册路由 - 使用
internal/response返回统一格式
构建
make build
./bin/server