fix(采集数据): 提交即启动+历史「等待中」单可重启——33462 挂 20 小时的入口缺失
线上 33462(uid=1245)建单后 status 一直 PENDING、updated_at 与 created_at 逐字相同、 receivedRows=0。取证:当天 15:46:06 的 parse 请求确实到达服务端,同批相邻的 33463/33464 都在几分钟内被 activate,唯独 33462 全天零次;ONLINE 通道的 PENDING 服务端没有任何兜底 (StaleTaskRepairService 明确跳过 PENDING、finalizeStaleTasks 只扫 RUNNING、 TaskResumeService 只处理 FAILED),而把这一单翻成 RUNNING 的唯一动作是前端发 activate, 它当时绑死在「本次会话刚 parse 的 lastTaskId」上——用户点完提交不点启动,界面就再无入口。 - submitCollect 成功后自动走启动链(两步并一步) - 历史行对 PENDING 单出「启动任务」,filters 取服务端从 request_json 回传的那份, 不取界面当前值,否则「重新启动」会悄悄改掉这一单的采集范围 - 三条启动路收敛为单一出口 useCollectDataDispatch(共用前置校验与入队失败回滚) - 缺桌面壳不再静默 return;回滚失败并进同一句报错,消掉搬文件带来的新增静默 catch 判据 tests/collect-data-提交即启动.test.ts(4 格,反向验过:改回旧形状 3 红) 组件 861→842 行(可读棘轮按对象点名只许减,未动基线)
This commit is contained in:
@@ -0,0 +1,122 @@
|
||||
// COLLECT_DATA 的启动链(唯一出口)。
|
||||
// 为什么单独成件:线上 33462 建单后 20 小时无人认领,根因是「提交」与「启动」是界面上的两个按钮,
|
||||
// 而 ONLINE 通道的 PENDING 服务端没有任何兜底会把它推起来(StaleTaskRepairService 明确跳过 PENDING、
|
||||
// finalizeStaleTasks 只扫 RUNNING、TaskResumeService 只处理 FAILED)。启动这一步要么由提交自动带出,
|
||||
// 要么能从历史行补点,两条路都必须走同一道前置校验与同一条入队失败回滚——分叉一处就会出现
|
||||
// 「闸门放行、任务仍带空凭据」那类事故(AGENTS.md 铁律 27)。
|
||||
import { shallowRef } from 'vue'
|
||||
|
||||
import { activateCollectDataTask, failCollectDataTask } from '@/shared/api/java-modules'
|
||||
import type { CollectDataFilters } from '@/shared/api/types/modules/collect-data'
|
||||
import { getPywebviewApi } from '@/shared/bridges/pywebview'
|
||||
import { checkQueuePayload } from '@/shared/dispatch-guard'
|
||||
import { passGuard } from '@/shared/dispatch-guard-ui'
|
||||
|
||||
/** 历史 VO 不带 pageSize(它是 parse 的返回字段);这里走出厂值,它只决定采集端每次拉多少行明细 */
|
||||
export const COLLECT_QUEUE_PAGE_SIZE = 50
|
||||
|
||||
export type CollectDispatchSource = {
|
||||
taskNo?: string
|
||||
totalRows?: number
|
||||
pageSize?: number
|
||||
filters?: CollectDataFilters
|
||||
}
|
||||
|
||||
export type CollectDispatchHooks = {
|
||||
/** 缺桌面壳、校验被拦、入队失败三类提示的出口,由界面层决定是 toast 还是卡片 */
|
||||
notify: (kind: 'warning' | 'error' | 'success', text: string) => void
|
||||
/** 启动链在跑时把界面上的启动按钮按住(含重复点击同一单的窗口) */
|
||||
onBusyChange: (busy: boolean) => void
|
||||
/** 启动成功后的界面回执(排队数与 payload 原文,供调试卡展示) */
|
||||
onDispatched: (payload: unknown, queueSize: number | string) => void
|
||||
/** 启动成功后登记进度轮询 */
|
||||
onStarted: (taskId: number) => void
|
||||
}
|
||||
|
||||
export function buildCollectQueuePayload(taskId: number, src: CollectDispatchSource) {
|
||||
return {
|
||||
type: 'collect-data-run',
|
||||
ts: Date.now(),
|
||||
data: {
|
||||
taskId,
|
||||
taskNo: src.taskNo,
|
||||
taskType: 'collect-data',
|
||||
totalRows: src.totalRows ?? 0,
|
||||
pageSize: src.pageSize ?? COLLECT_QUEUE_PAGE_SIZE,
|
||||
filters: src.filters ?? {},
|
||||
},
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 提交即启动与历史「等待中」单重启共用的启动链。
|
||||
* 返回 true 只在「已 activate 且已进本机队列」时成立,调用方据此决定是否刷新看板。
|
||||
*/
|
||||
export function useCollectDataDispatch(hooks: CollectDispatchHooks) {
|
||||
/** 正在启动中的任务号:同一单重复点击会二次 activate,第二次只是被条件更新拒掉的无效请求 */
|
||||
const startingTaskIds = shallowRef<Set<number>>(new Set())
|
||||
|
||||
function markStarting(taskId: number, starting: boolean) {
|
||||
const next = new Set(startingTaskIds.value)
|
||||
if (starting) next.add(taskId)
|
||||
else next.delete(taskId)
|
||||
startingTaskIds.value = next
|
||||
}
|
||||
|
||||
function isStarting(taskId: number): boolean {
|
||||
return startingTaskIds.value.has(taskId)
|
||||
}
|
||||
|
||||
async function dispatch(taskId: number, src: CollectDispatchSource): Promise<boolean> {
|
||||
const api = getPywebviewApi()
|
||||
if (!api?.enqueue_json) {
|
||||
// 这里曾是一句轻警告加静默 return:单子已落库成 PENDING,不会有任何东西把它推起来。
|
||||
// 提示必须点名「等待中」与下一步动作,把用户引去等一个不会来的自动重试是我们的错。
|
||||
hooks.notify('warning',
|
||||
'当前环境未提供任务队列能力:请在桌面客户端里对这一单点「启动任务」。单子已保存,状态「等待中」不会自动开始采集')
|
||||
return false
|
||||
}
|
||||
if (isStarting(taskId)) return false
|
||||
markStarting(taskId, true)
|
||||
hooks.onBusyChange(true)
|
||||
let activated = false
|
||||
try {
|
||||
const payload = buildCollectQueuePayload(taskId, src)
|
||||
// 先校验再激活:拦下来时任务还是 PENDING,不需要回滚成 FAILED
|
||||
const guard = checkQueuePayload(payload, {
|
||||
expectedType: 'collect-data-run',
|
||||
requiredDataKeys: ['taskId', 'pageSize'],
|
||||
nonEmptyObjectKeys: ['filters'],
|
||||
})
|
||||
if (!(await passGuard(guard))) return false
|
||||
await activateCollectDataTask(taskId)
|
||||
activated = true
|
||||
const result = await api.enqueue_json(payload)
|
||||
if (!result?.success) {
|
||||
throw new Error(result?.error || '启动失败')
|
||||
}
|
||||
hooks.onDispatched(payload, result.queue_size ?? '-')
|
||||
hooks.onStarted(taskId)
|
||||
hooks.notify('success', '已启动任务')
|
||||
return true
|
||||
} catch (error) {
|
||||
let rollbackNote = ''
|
||||
if (activated) {
|
||||
try {
|
||||
await failCollectDataTask(taskId, error instanceof Error ? error.message : 'Python queue dispatch failed')
|
||||
} catch {
|
||||
// 回滚自己失败也必须让用户看见:这一单已经被 activate 成 RUNNING 却没进本机队列,
|
||||
// 标失败没成功的话它就停在「等待中」等一个不会来的自动重试。不并进同一句报错就会变成静默 catch。
|
||||
rollbackNote = ';且把这一单标成失败也没成功,它仍停在「等待中」,需要手动删除或重新启动'
|
||||
}
|
||||
}
|
||||
hooks.notify('error', `${error instanceof Error ? error.message : '启动失败'}${rollbackNote}`)
|
||||
return false
|
||||
} finally {
|
||||
markStarting(taskId, false)
|
||||
hooks.onBusyChange(false)
|
||||
}
|
||||
}
|
||||
|
||||
return { dispatch, isStarting }
|
||||
}
|
||||
Reference in New Issue
Block a user