feat: optionally enforce API-key spending windows in simple mode

This commit is contained in:
zhangcj committed 2026-09-23 08:17:48 +08:00
1 parent 20a94fbb56
commit 3b336b2eca
18 files changed
+509 -36

No files matched your search

@@ -733,8 +733,13 @@ func (s *BillingCacheService) IncrementUserPlatformQuotaUsage(userID int64, plat
// 订阅模式:检查缓存用量未超过限额(Group限额从参数传入)
// platform 为请求的目标平台(如 "anthropic"),传空串 "" 时跳过 user × platform quota 检查。
func (s *BillingCacheService) CheckBillingEligibility(ctx context.Context, user *User, apiKey *APIKey, group *Group, subscription *UserSubscription, platform string) error {
// 简易模式:跳过所有计费检查
if s.cfg.RunMode == config.RunModeSimple {
// 简易模式默认跳过所有计费检查. An explicit key-window opt-in keeps
// balance/subscription/platform checks bypassed while enforcing the three
// API-key monetary windows from the database source of truth.
if s.cfg != nil && s.cfg.RunMode == config.RunModeSimple {
if s.cfg.SimpleModeKeyRateLimitEnabled {
return s.checkSimpleModeAPIKeyRateLimits(ctx, apiKey)
}
return nil
}
if s.circuitBreaker != nil && !s.circuitBreaker.Allow() {
@@ -776,6 +781,34 @@ func (s *BillingCacheService) CheckBillingEligibility(ctx context.Context, user
return nil
}
// checkSimpleModeAPIKeyRateLimits is deliberately DB-authoritative. Redis
// updates are asynchronous and can be dropped or missed after a committed
// transaction, so using the cache here could let a limited simple-mode key
// continue past its configured window. A read failure fails closed because
// the operator explicitly opted into enforcement.
func (s *BillingCacheService) checkSimpleModeAPIKeyRateLimits(ctx context.Context, apiKey *APIKey) error {
if apiKey == nil || !apiKey.HasRateLimits() {
return nil
}
if s.apiKeyRateLimitLoader == nil {
return ErrBillingServiceUnavailable
}
data, err := s.apiKeyRateLimitLoader.GetRateLimitData(ctx, apiKey.ID)
if err != nil || data == nil {
return ErrBillingServiceUnavailable
}
if apiKey.RateLimit5h > 0 && data.EffectiveUsage5h() >= apiKey.RateLimit5h {
return ErrAPIKeyRateLimit5hExceeded
}
if apiKey.RateLimit1d > 0 && data.EffectiveUsage1d() >= apiKey.RateLimit1d {
return ErrAPIKeyRateLimit1dExceeded
}
if apiKey.RateLimit7d > 0 && data.EffectiveUsage7d() >= apiKey.RateLimit7d {
return ErrAPIKeyRateLimit7dExceeded
}
return nil
}
// checkRPM 执行并行 RPM 限流,所有适用的限制同时生效,任一超限即拒绝:
//
// 1. (用户, 分组) rpm_override — 最细粒度:管理员为特定用户在特定分组设定的专属限额。