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:
+91
@@ -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
-1
@@ -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());
|
||||
|
||||
+7
-2
@@ -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;
|
||||
|
||||
Reference in New Issue
Block a user