feat: 集成限流器到服务 #178

huanghaosheng · 2026-06-21T13:24:50+08:00

huanghaosheng commented

2026-06-21 13:24:50 +08:00

No description provided.

huanghaosheng added 12 commits 2026-06-21 13:24:50 +08:00

feat: 添加限流配置层 a6df8c9131

- Config 结构体新增 RateLimit 字段
- 新增 RateLimitConfig 和 BucketConfig 结构体定义
- config.yaml 新增 ratelimit 配置段（默认关闭）
- 设置默认值：query(10/0.2)、login(5/0.1)、register(3/0.05)

feat: 实现内存令牌桶限流器 3b6226394b

- Limiter 接口定义（Allow + Stop 方法）
- TokenBucket 实现（容量、填充速率、并发安全）
- MemoryLimiter 管理多用户令牌桶
- 后台 goroutine 定期清理不活跃桶（10 分钟）
- 完整单元测试覆盖（11 个测试用例，全部通过）
- 边界情况处理（rate=0、capacity=0、并发安全）

feat: 实现 Redis 令牌桶限流器 b74fb3564d

- RedisLimiter 基于 Lua 脚本保证原子性
- Lua 脚本实现完整令牌桶算法（填充、消耗、TTL）
- fail-open 策略：Redis 故障时允许请求通过
- FormatKey 辅助函数格式化限流 key
- 完整单元测试（10 个测试用例，使用 miniredis）
- 测试覆盖：首次请求、耗尽、不同用户、补充、容量上限、零速率、TTL、故障降级

feat: 实现 Gin 限流中间件 ea00939c13

- Middleware 函数返回 Gin 中间件
- keyFunc 参数支持灵活提取限流 key（IP/用户 ID 等）
- 限流触发时返回 HTTP 429 + Retry-After header
- 支持 nil limiter（跳过限流）和空 key（跳过限流）
- 完整单元测试（6 个测试用例，全部通过）
- 测试覆盖：允许、拒绝、nil limiter、空 key、keyFunc、Retry-After 舍入

feat: 集成限流器到服务 7adf81c6e5

- main.go 初始化限流器（根据 Redis 可用性选择内存/Redis 实现）
- WebSocket handler 添加 query 消息限流（按 userID）
- Auth API 添加登录/注册限流（按 IP）
- refresh 和 logout 不限流（避免影响正常用户操作）
- 修复所有测试（传递 nil limiter 参数）
- 所有测试通过（包括 ws 和 api 集成测试）

refactor: 重组配置文件到 config 目录 311330cea1

- 创建 backend/config/ 目录统一管理配置文件
- 移动 config.yaml 到 config/config.yaml
- 新增 config.dev.yaml 开发环境配置（debug 日志、关闭限流）
- 新增 config.prod.yaml 生产环境配置（info 日志、启用限流、严格 CORS）
- 更新配置加载逻辑，优先从 config/ 目录读取，兼容旧路径
- 更新 .gitignore，仅排除 .env，配置文件纳入版本控制

docs: 完善配置环境切换机制 515d7ae034

- docker-compose.yml 添加 APP_ENV=prod 强制生产环境
- 更新 .env.example 的 APP_ENV 注释说明（开发/生产差异）
- CLAUDE.md 补充"配置环境切换"章节，说明本地开发和生产部署的配置切换方式
- 明确配置优先级：环境变量 > config.{env}.yaml > config.yaml > 默认值

配置差异：
- 开发环境：debug 日志、关闭限流、允许所有 CORS
- 生产环境：info/json 日志、启用限流、严格 CORS 白名单

验证通过：
- 本地开发：默认加载 config.dev.yaml（env=dev, debug 日志）
- 生产配置：APP_ENV=prod 加载 config.prod.yaml（env=prod, info 日志）

refactor: 开发环境使用与生产环境相同的 AI 模型配置 252cdcc8e7

- config.dev.yaml 补全 AI 服务配置（provider、model、endpoint）
- 保持开发环境超时时间较长（方便调试）
- 确保开发和生产环境使用相同的模型，避免环境差异导致的问题

refactor: 移除生产环境配置文件中 CORS 配置 d53265755a

Merge pull request 'feat: 集成限流器到服务' (#176 ) from feature/ratelimit into develop 19645be04e

Reviewed-on: http://8.161.227.145:3000/XEngineers/CamTalk/pulls/176

docs: 规范文档对跨域处理的介绍 910e71b6f0

Merge pull request 'docs: 规范文档对跨域处理的介绍' (#177 ) from feature/ratelimit into develop 361c5d07d3

Reviewed-on: http://8.161.227.145:3000/XEngineers/CamTalk/pulls/177

huanghaosheng merged commit d0f5f5c94d into v2

2026-06-21 13:25:06 +08:00

huanghaosheng referenced this issue from a commit

2026-06-21 13:25:09 +08:00

Merge pull request 'feat: 集成限流器到服务' (#178) from develop into v2

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: XEngineers/CamTalk#178