fix(brand-check): 补测耗尽通知按失败类别说话,代理套餐问题不再算成上游的锅

16890 改烧任务归属用户自己的代理提取链接后,失败主因从上游不可用变成用户侧套餐:
现网 12 分钟内 18 条「全部 N 把代理 key 处于冷却」、4 条「余额不足」。而耗尽通知仍一律写
「上游商标库持续不可用,建议稍后重新提交采集任务重跑这些 ASIN」——既把账算到别人头上,
又把人推向"重跑必然还是同样失败"的那条路。

- 新增 BrandCheckFailureNotice:原始原因 → Kind(未配置/套餐耗尽/冷却/出口被拒/技术性/上游),
  每类给一句"发生了什么 + 该做什么",代理侧全部指向「密钥设置」的「代理设置」。
- 拒付判定排在冷却之前:key 因余额不足被拒后整批写冷却,只报冷却等于让用户白等。
- pushRecheckOutcome 多收一个 Kind,耗尽分支改用它给的句子;last_error 照库存原文供后台取证。
- 30 支用例(分类器 9 / 通知 7 / 调度 10,含冷却原话透传到通知那支),判据串取自现网读到的原文。
This commit is contained in:
2026-10-20 23:05:29 +08:00
parent b9fb25c270
commit 74384fa6ac
6 changed files with 269 additions and 18 deletions
@@ -0,0 +1,91 @@
package com.nanri.aiimage.modules.brand.support;
import com.nanri.aiimage.modules.brand.client.BrandCheckClient;
import java.util.regex.Pattern;
/**
* 把 16890 品牌检测回来的原始原因归成"用户看得懂的那一类",并给出该做的动作。
*
* <p>存在的理由只有一句:2026-10-20 品牌检测改成烧**任务归属用户自己的**代理提取链接后,
* 失败主因从「上游商标库不可用」变成了用户侧套餐问题(现网 12 分钟内 18 条冷却、4 条余额不足),
* 而补测耗尽通知还写着「上游商标库持续不可用」——既冤枉了上游,也让用户照着提示去重跑,
* 重跑当然还是失败。原始原因照旧进 {@code biz_collectdata_brand_recheck.last_error}
* 供后台取证,这里只管对用户说话的那一句。
*/
public final class BrandCheckFailureNotice {
public enum Kind {
/** 没配代理提取链接:不是查不到,是根本没得查,动作最明确。 */
PROXY_NOT_CONFIGURED,
/** 套餐余额不足/过期/未开通:不充值或换链接,重跑多少次都一样。 */
PROXY_PACKAGE_EXHAUSTED,
/** 所有 key 都在拒付冷却窗口里:短时现象,补测轮会自动再来。 */
PROXY_COOLDOWN,
/** 代理出口 IP 被商标库拒绝。 */
PROXY_EGRESS_REJECTED,
/** 提取没返回可用 IP、请求失败、解密失败等本地/链路技术性失败。 */
TECHNICAL,
/** 上游商标库本身不可用,或上游没给原因(含连接层失败)。 */
UPSTREAM
}
/** 供应商拒付类话术(与 16890 侧判拒付用的关键字同一套)。 */
private static final Pattern PACKAGE_EXHAUSTED = Pattern.compile("余额不足|欠费|套餐不存在|套餐已过期|套餐过期|未开通");
private static final Pattern COOLDOWN = Pattern.compile("处于冷却|冷却窗口|冷却");
private static final Pattern EGRESS_REJECTED = Pattern.compile("拒绝代理出口|出口 IP|换 IP 重试");
private static final Pattern TECHNICAL = Pattern.compile(
"查询或解密失败|代理请求失败|未返回可用 IP|提取失败|解密");
private BrandCheckFailureNotice() {
}
/**
* 原始原因 → 类别。空串按「上游」算:Java 自己在连接层失败时拿不到上游的 reason,
* 那种情况下能观测到的事实也只有"没回来"。
*
* <p>拒付判定在冷却之前:一把 key 因余额不足被拒后,随后的整批都写成"处于冷却",
* 但那句是冷却、根因是套餐,两个都命中时取更靠根因的那一类。
*/
public static Kind classify(String rawReason) {
String reason = rawReason == null ? "" : rawReason.trim();
if (reason.isEmpty()) {
return Kind.UPSTREAM;
}
if (BrandCheckClient.NO_PROXY_REASON.equals(reason)) {
return Kind.PROXY_NOT_CONFIGURED;
}
if (PACKAGE_EXHAUSTED.matcher(reason).find()) {
return Kind.PROXY_PACKAGE_EXHAUSTED;
}
if (COOLDOWN.matcher(reason).find()) {
return Kind.PROXY_COOLDOWN;
}
if (EGRESS_REJECTED.matcher(reason).find()) {
return Kind.PROXY_EGRESS_REJECTED;
}
if (TECHNICAL.matcher(reason).find()) {
return Kind.TECHNICAL;
}
return Kind.UPSTREAM;
}
/** 用户可读的那一句:先说发生了什么,再说该做什么。 */
public static String userMessage(Kind kind) {
if (kind == null) {
return "商标库本次未返回结果,系统会在后续补测轮自动重试。";
}
return switch (kind) {
case PROXY_NOT_CONFIGURED -> "这个账号还没配代理提取链接,品牌检测无法发起查询:"
+ "请在「密钥设置」的「代理设置」里补上后重跑这些行。";
case PROXY_PACKAGE_EXHAUSTED -> "你的代理提取套餐余额不足或已过期,"
+ "请在「密钥设置」的「代理设置」里充值或更换提取链接,否则重跑也会同样失败。";
case PROXY_COOLDOWN -> "你的代理提取链接连续被供应商拒绝,短时间内已不再尝试;"
+ "系统会在后续补测轮自动重试,若反复出现请检查「密钥设置」的「代理设置」里的套餐余量。";
case PROXY_EGRESS_REJECTED -> "代理出口 IP 被商标库拒绝,系统会自动换出口并在后续补测轮重试;"
+ "持续如此时请更换「密钥设置」的「代理设置」里的提取链接。";
case TECHNICAL -> "品牌检测本次没取回结果(代理提取或结果解析未成功),系统会在后续补测轮自动重试。";
case UPSTREAM -> "上游商标库暂时不可用,系统会在后续补测轮自动重试。";
};
}
}
@@ -3,6 +3,7 @@ package com.nanri.aiimage.modules.collectdata.service;
import com.nanri.aiimage.common.service.DistributedJobLockService;
import com.nanri.aiimage.config.CollectDataBrandRecheckProperties;
import com.nanri.aiimage.modules.brand.client.BrandCheckClient;
import com.nanri.aiimage.modules.brand.support.BrandCheckFailureNotice;
import com.nanri.aiimage.modules.collectdata.model.entity.CollectDataBrandRecheckEntity;
import com.nanri.aiimage.modules.collectdata.service.CollectDataBrandRecheckInjector.RecheckVerdict;
import com.nanri.aiimage.modules.collectdata.util.CollectDataBrandBatchFilter;
@@ -220,7 +221,8 @@ public class CollectDataBrandRecheckScheduler {
}
notificationDispatchService.pushRecheckOutcome(task.getUserId(), task.getId(), MODULE_TYPE,
task.getTaskNo(), outcome.acceptedRows(), outcome.rejectedRows(),
stillFailedEntries.size(), exhaustedThisRound);
stillFailedEntries.size(), exhaustedThisRound,
BrandCheckFailureNotice.classify(checkReason));
log.info("[brand-recheck] 任务组完成 taskId={} 品牌={} 净={} 败={} 仍失败={} 收口={} 新增结果行={} 判定无效行={}",
task.getId(), brands.size(), cleanEntries.size(), rejectedEntries.size(),
stillFailedEntries.size(), exhaustedThisRound, outcome.acceptedRows(), outcome.rejectedRows());
@@ -5,6 +5,7 @@ import com.nanri.aiimage.common.module.TaskModuleRegistry;
import com.nanri.aiimage.common.security.AdminAuthSupport;
import com.nanri.aiimage.common.mapper.AdminUserMapper;
import com.nanri.aiimage.common.model.entity.AdminUserEntity;
import com.nanri.aiimage.modules.brand.support.BrandCheckFailureNotice;
import com.nanri.aiimage.modules.permission.support.UserDataScopeSupport;
import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
@@ -143,7 +144,8 @@ public class NotificationDispatchService {
* 同任务同自然日一条(dedupe_key 带日期):补测按轮推进,同一轮内多品牌合并成一条。
*/
public void pushRecheckOutcome(Long userId, Long taskId, String moduleType, String taskNo,
int injectedRows, int rejectedRows, int pendingRows, int exhaustedRows) {
int injectedRows, int rejectedRows, int pendingRows, int exhaustedRows,
BrandCheckFailureNotice.Kind failureKind) {
if (userId == null || userId <= 0 || taskId == null) {
return;
}
@@ -164,8 +166,11 @@ public class NotificationDispatchService {
+ "。结果文件已更新,可在「历史任务」重新下载。";
} else {
title = label + "任务品牌补测未能完成";
// 这句过去一律写成「上游商标库持续不可用」并建议重跑——2026-10-20 起品牌检测烧的是
// 用户自己的代理提取链接,主因变成套餐/冷却,那句既冤枉上游又把用户推向"重跑还是失败"。
// 原始原因照旧留在补测条目 last_error 里给后台取证。
content = "任务 " + displayTaskNo + ":品牌检测连续多轮自动补测仍未成功,共 " + exhaustedRows
+ " 行未能补出结论(上游商标库持续不可用)。建议稍后重新提交采集任务重跑这些 ASIN。";
+ " 行未能补出结论。" + BrandCheckFailureNotice.userMessage(failureKind);
}
String level = fixed && pendingRows <= 0
? NotificationService.LEVEL_INFO : NotificationService.LEVEL_WARNING;