fix(llm): 余额耗尽按「余额欠费」归因且不再重试进冷却

- 新增 LlmBalanceGuard:识别 insufficient_user_quota 等上游余额/额度字样
- SimilarAsin/AppearancePatent 客户端命中后一次就停,不落进不可达/冷却分支
- 单测:识别口径 3 例 + 两客户端各 1 例(只发 1 次、文案含余额欠费)
This commit is contained in:
2026-10-27 10:04:03 +08:00
parent e0abd33ed4
commit f3445c21c8
6 changed files with 169 additions and 0 deletions
@@ -2,6 +2,7 @@ package com.nanri.aiimage.modules.appearancepatent.client;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.nanri.aiimage.common.retry.LlmBalanceGuard;
import com.nanri.aiimage.common.retry.LlmKeyGate;
import com.nanri.aiimage.common.retry.LlmRetryBackoff;
import com.nanri.aiimage.common.retry.UnreachableCooldown;
@@ -691,6 +692,14 @@ public class AppearancePatentLlmClient {
if (LlmKeyGate.isRateLimited(ex)) {
LlmKeyGate.penalizeRateLimited(apiKey, 2_000L);
}
if (LlmBalanceGuard.isQuotaExhausted(ex)) {
// 余额欠费不是连接层故障,重试救不回来:一次就停,按欠费归因,不落进冷却分支
unreachableCooldown.recordConnected(host);
log.warn("[appearance-patent] LLM_BALANCE_DUE 上游账户余额不足,停止重试 attempt={} model={} err={}",
attempt, model, failureMessage(ex));
throw new IllegalStateException(
LlmBalanceGuard.REASON_LLM_BALANCE_DUE + ";lastErr=" + failureMessage(ex), ex);
}
lastFailure = ex;
if (UnreachableCooldown.isConnectFailure(ex)) {
boolean entered = unreachableCooldown.recordConnectFailure(host, cooldownMillis);
@@ -2,6 +2,7 @@ package com.nanri.aiimage.modules.similarasin.client;
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.nanri.aiimage.common.retry.LlmBalanceGuard;
import com.nanri.aiimage.common.retry.LlmKeyGate;
import com.nanri.aiimage.common.retry.LlmRetryBackoff;
import com.nanri.aiimage.common.retry.UnreachableCooldown;
@@ -119,6 +120,14 @@ public class SimilarAsinLlmClient {
// 429 时把同 key 的下一次许可整体后移,避免所有调用一起再撞
LlmKeyGate.penalizeRateLimited(resolvedKey, 2_000L);
}
if (LlmBalanceGuard.isQuotaExhausted(ex)) {
// 余额欠费不是连接层故障,重试救不回来:一次就停,按欠费归因,不落进冷却分支
unreachableCooldown.recordConnected(host);
log.warn("[similar-asin][llm] LLM_BALANCE_DUE 上游账户余额不足,停止重试 attempt={} model={} err={}",
attempt, model, failureMessage(ex));
throw new IllegalStateException(
LlmBalanceGuard.REASON_LLM_BALANCE_DUE + ";lastErr=" + failureMessage(ex), ex);
}
lastFailure = ex;
if (UnreachableCooldown.isConnectFailure(ex)) {
connectFailures++;