feat(护栏三面): 鉴权盲区启动自检 + SQL 分层口径落码 + 六页等待循环合一
后端
- AdminApiGuardFilter 增 guardedPrefixes()/matchesPrefix() 公开入口(原 private,
自检抄一份清单迟早与守卫脱钩);行为零变化
- 新增 ApiGuardCoverageAuditor:启动期把"已映射端点既不在守卫前缀名单、也不在
公开/待收清单里"打成 API_GUARD_UNCOVERED 一行 WARN,供现网巡检 grep;
PUBLIC_BY_DESIGN 与 PENDING_CONVERGENCE 两张清单逐条写理由(只读不拦)
- SQL 分层按新口径落码:AsinResultCacheMapper 的两条动态 SQL(<foreach> 批量 +
ON DUPLICATE KEY UPDATE + 逐列 COALESCE)迁到 resources/mapper/asincache/,
注解摘干净(注解+XML 同名会让启动期抛重复语句)
- 判据:SqlLayeringConventionTest(注解写 SQL 基线 16 接口/29 条只减不增、
@Select 65 条/16 文件、wrapper 夹带函数级 SQL 4 文件/15 条,last("LIMIT n")
205 处显式豁免并反向钉住豁免面)、ApiGuardCoverageAuditorTest(含清单腐烂与
欠账/名单重叠两类反向失明)、AsinResultCacheMapperXmlTest(真解析 XML 向
BoundSql 断言 28 个占位符与 5 个 COALESCE 列)
用户端 frontend-vue
- 终态集合合一:实测六页里 PriceTrack/ProductRisk 只认 SUCCESS|FAILED,
而 COMPLETED≡SUCCESS 早有出处(task-status-text 两者都译「已完成」,
后端 TaskCenterQueryMapper SUCCESS_STATUSES_ORDERED 也含 COMPLETED)
⇒ 窄集合页收到 COMPLETED 会空转到瞬断预算耗尽,PriceTrack 的轮询摘除路径
同样窄 ⇒ 任务永不退出轮询、列表卡在"执行中"
- 新增 shared/utils/task-terminal.ts 循环骨架(disposed/瞬断预算/恢复提示/
每轮 sleep/非瞬断上抛),六页全部接上;取数、文案、快照合并、DELETED 语义
留在各页回调,没有顺手统一
- 判据两支:骨架 8 例契约 + 六页源码窄集合回归钉(含"判据自己先自证"一例,
loop-run 的 STOPPED 词表不误报)
This commit is contained in:
@@ -0,0 +1,84 @@
|
||||
/**
|
||||
* 任务终态等待的共用骨架(原先在 6 个品牌 Tab 里各写一份 while(true))。
|
||||
*
|
||||
* 抽这一层的原因不是"代码重复",而是**终态集合六份不一致**:
|
||||
* PriceTrack / ProductRisk / ShopMatch 三页只认 `SUCCESS|FAILED`,另三页认 `SUCCESS|COMPLETED|FAILED`。
|
||||
* 而 COMPLETED≡SUCCESS 在两头早就定了:本仓统一文案表 `shared/utils/task-status-text.ts`
|
||||
* 把两者都映射成「已完成」/success 样式,后端看板 `TaskCenterQueryMapper.SUCCESS_STATUSES_ORDERED`
|
||||
* 也是 List.of("SUCCESS","COMPLETED")。窄集合那三页一旦收到 COMPLETED(后端 delete-brand 链路
|
||||
* 与本地会话态 `BrandDeleteBrandTab:611` 都会产出这个值)就会**一路空转到 30 次瞬断预算耗尽**,
|
||||
* 用户看到的是"任务永远执行中",而服务端那边任务早就结束了。
|
||||
*
|
||||
* 除状态外的差异(取数方式、提示文案、页专属副作用)留在调用方回调里,本文件不统一它们:
|
||||
* 那部分是各页的业务形状,合并只会把差异藏起来。
|
||||
*/
|
||||
|
||||
/** 与 task-status-text 的 success/failed 分类一致;CANCELLED 不在任务等待面出现,故不列。 */
|
||||
export const TERMINAL_TASK_STATUSES: readonly string[] = ['SUCCESS', 'COMPLETED', 'FAILED']
|
||||
|
||||
export function isTerminalTaskStatus(status?: string): boolean {
|
||||
if (!status) return false
|
||||
return TERMINAL_TASK_STATUSES.includes(status.trim().toUpperCase())
|
||||
}
|
||||
|
||||
/** 各页瞬断容忍次数原本都是 30,抽成默认值以免第六份再抄一遍。 */
|
||||
export const DEFAULT_TRANSIENT_BUDGET = 30
|
||||
|
||||
export interface TaskTerminalWait {
|
||||
taskId: number
|
||||
/** 页面卸载/停止时返回 true ⇒ 立刻以 'STOPPED' 退出(原先六页都写 `if (disposed) return 'STOPPED'`)。 */
|
||||
isDisposed: () => boolean
|
||||
/**
|
||||
* 取一次状态。返回空串表示"还没到终态,继续等"。
|
||||
* 页专属判定(任务行被删、会话切走、结果文件还没生成)留在这里,
|
||||
* 需要立刻收尾时返回一个终态值即可——`DELETED` / `FAILED` 由各页自己决定,骨架不猜。
|
||||
*/
|
||||
pollStatus: () => Promise<string>
|
||||
/** 每轮一次的页专属副作用(合并快照、刷新进度文案)。 */
|
||||
onStatus?: (status: string) => void
|
||||
/** 瞬断后恢复时的一次提示。 */
|
||||
onRecovered?: () => void
|
||||
/** 每次瞬断的提示(attempt 从 1 开始)。 */
|
||||
onTransient?: (attempt: number, budget: number) => void
|
||||
/** 瞬断判定,沿用各页原有的 TRANSIENT_BACKEND_ERROR_PATTERNS 口径。 */
|
||||
isTransient: (error: unknown) => boolean
|
||||
/** 预算耗尽:六页原本都是 throw(措辞各异),所以默认抛通用文案。 */
|
||||
onBudgetExhausted?: (attempt: number) => never
|
||||
intervalMs: () => number
|
||||
sleep: (ms: number) => Promise<void>
|
||||
transientBudget?: number
|
||||
terminal?: readonly string[]
|
||||
}
|
||||
|
||||
/**
|
||||
* 等到任务终态并返回那个状态字符串。
|
||||
*
|
||||
* 与旧实现保持同一点行为:非瞬断异常照常上抛(不吞),只有被 `isTransient` 认出的错误才计预算;
|
||||
* 预算内的每一轮都 sleep 后再看,disposed 优先于一切判定先返回。
|
||||
*/
|
||||
export async function waitForTaskTerminal(wait: TaskTerminalWait): Promise<string> {
|
||||
const budget = wait.transientBudget ?? DEFAULT_TRANSIENT_BUDGET
|
||||
const terminal = wait.terminal ?? TERMINAL_TASK_STATUSES
|
||||
let transientErrors = 0
|
||||
|
||||
while (true) {
|
||||
if (wait.isDisposed()) return 'STOPPED'
|
||||
try {
|
||||
const status = await wait.pollStatus()
|
||||
if (transientErrors > 0) wait.onRecovered?.()
|
||||
transientErrors = 0
|
||||
wait.onStatus?.(status)
|
||||
const normalized = (status || '').trim().toUpperCase()
|
||||
if (normalized && terminal.includes(normalized)) return normalized
|
||||
} catch (error) {
|
||||
if (!wait.isTransient(error)) throw error
|
||||
transientErrors += 1
|
||||
if (transientErrors >= budget) {
|
||||
if (wait.onBudgetExhausted) return wait.onBudgetExhausted(transientErrors)
|
||||
throw new Error(`任务 ${wait.taskId} 等待服务恢复超时,请稍后刷新查看状态`)
|
||||
}
|
||||
wait.onTransient?.(transientErrors, budget)
|
||||
}
|
||||
await wait.sleep(wait.intervalMs())
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user