207225eb86
后端
- 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 词表不误报)
119 lines
4.5 KiB
TypeScript
119 lines
4.5 KiB
TypeScript
// 任务终态等待骨架的行为契约。跑法:npm test(node --test tests/*.test.ts)
|
||
import { test } from 'node:test'
|
||
import assert from 'node:assert/strict'
|
||
|
||
import {
|
||
DEFAULT_TRANSIENT_BUDGET,
|
||
TERMINAL_TASK_STATUSES,
|
||
isTerminalTaskStatus,
|
||
waitForTaskTerminal,
|
||
} from '../src/shared/utils/task-terminal.ts'
|
||
|
||
/**
|
||
* 只替 IO 边界(取数/睡眠/ disposed),循环本体真跑。
|
||
* sleep 里把 disposed 置上,避免非终态分支把用例吊死;keepPolling 让状态序列能走完。
|
||
*/
|
||
function harness(overrides: any = {}) {
|
||
const state: any = {
|
||
disposed: false,
|
||
statuses: [] as string[],
|
||
errors: [] as Error[],
|
||
sleeps: [] as number[],
|
||
keepPolling: false,
|
||
...overrides,
|
||
}
|
||
const base: any = {
|
||
taskId: 7,
|
||
isDisposed: () => state.disposed,
|
||
pollStatus: async () => {
|
||
if (state.errors.length) throw state.errors.shift()
|
||
return state.statuses.length > 1 ? state.statuses.shift() : state.statuses[0] ?? ''
|
||
},
|
||
intervalMs: () => 1000,
|
||
isTransient: (error: any) =>
|
||
/502|503|504|无法连接到服务|bad gateway|gateway timeout|network error|timeout/i.test(
|
||
String(error?.message ?? error),
|
||
),
|
||
sleep: async (ms: number) => {
|
||
state.sleeps.push(ms)
|
||
if (!state.keepPolling) state.disposed = true
|
||
},
|
||
}
|
||
return { state, base }
|
||
}
|
||
|
||
test('COMPLETED 是终态:窄集合那三页以前会空转到预算耗尽', async () => {
|
||
const { base, state } = harness({ keepPolling: true })
|
||
state.statuses = ['RUNNING', 'COMPLETED']
|
||
|
||
assert.equal(await waitForTaskTerminal(base), 'COMPLETED')
|
||
assert.equal(state.statuses.length, 1, 'COMPLETED 命中后不该继续把队列取空')
|
||
})
|
||
|
||
test('SUCCESS 与 FAILED 同样立即终止', async () => {
|
||
for (const status of ['SUCCESS', 'FAILED']) {
|
||
const { base } = harness()
|
||
base.pollStatus = async () => status
|
||
assert.equal(await waitForTaskTerminal(base), status)
|
||
}
|
||
})
|
||
|
||
test('非终态继续等,并且每轮按页面给的间隔睡一次', async () => {
|
||
const { base, state } = harness({ keepPolling: true })
|
||
state.statuses = ['RUNNING', 'PENDING', 'QUEUED', 'SUCCESS']
|
||
|
||
assert.equal(await waitForTaskTerminal(base), 'SUCCESS')
|
||
assert.equal(state.sleeps.length, 3, '前三轮非终态各睡一次,第四轮命中即返回')
|
||
assert.ok(state.sleeps.every((ms) => ms === 1000), 'sleep 用的是 intervalMs 的值')
|
||
})
|
||
|
||
test('disposed 优先于一切判定', async () => {
|
||
const { base, state } = harness()
|
||
state.disposed = true
|
||
state.statuses = ['SUCCESS']
|
||
assert.equal(await waitForTaskTerminal(base), 'STOPPED')
|
||
})
|
||
|
||
test('瞬断计预算、恢复后清零、耗尽时抛错', async () => {
|
||
const transient = () => new Error('502 Bad Gateway')
|
||
|
||
const recovered = harness({ keepPolling: true })
|
||
const attempts: number[][] = []
|
||
recovered.base.onTransient = (attempt: number, budget: number) => attempts.push([attempt, budget])
|
||
recovered.state.errors = [transient(), transient()]
|
||
recovered.state.statuses = ['RUNNING', 'SUCCESS']
|
||
assert.equal(await waitForTaskTerminal(recovered.base), 'SUCCESS')
|
||
assert.deepEqual(attempts, [[1, DEFAULT_TRANSIENT_BUDGET], [2, DEFAULT_TRANSIENT_BUDGET]])
|
||
|
||
const exhausted = harness({ keepPolling: true })
|
||
exhausted.state.statuses = ['RUNNING']
|
||
exhausted.state.errors = Array.from({ length: DEFAULT_TRANSIENT_BUDGET }, transient)
|
||
await assert.rejects(() => waitForTaskTerminal(exhausted.base), /等待服务恢复超时/)
|
||
})
|
||
|
||
test('非瞬断异常直接上抛,不被骨架吞掉', async () => {
|
||
const { base, state } = harness({ keepPolling: true })
|
||
state.errors = [new Error('任务不存在')]
|
||
state.statuses = ['RUNNING']
|
||
await assert.rejects(() => waitForTaskTerminal(base), /任务不存在/)
|
||
})
|
||
|
||
test('页专属终态(DELETED)必须显式传 terminal 才生效', async () => {
|
||
const { base } = harness({ keepPolling: true })
|
||
base.pollStatus = async () => 'DELETED'
|
||
|
||
// 默认集合里没有 DELETED ⇒ 巡店删除页必须自己把它列进 terminal,否则会永远等下去
|
||
const widened = await waitForTaskTerminal({
|
||
...base,
|
||
terminal: [...TERMINAL_TASK_STATUSES, 'DELETED'],
|
||
})
|
||
assert.equal(widened, 'DELETED')
|
||
})
|
||
|
||
test('isTerminalTaskStatus 与集合口径一致', () => {
|
||
assert.equal(isTerminalTaskStatus('completed'), true, '大小写不敏感')
|
||
assert.equal(isTerminalTaskStatus(' RUNNING '), false)
|
||
assert.equal(isTerminalTaskStatus(undefined), false, '空状态不能算终态')
|
||
assert.deepEqual([...TERMINAL_TASK_STATUSES].sort(), ['COMPLETED', 'FAILED', 'SUCCESS'])
|
||
})
|