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:
2026-11-06 12:27:18 +08:00
parent 62e92003f2
commit 89a69d651e
3 changed files with 235 additions and 63 deletions
@@ -93,10 +93,10 @@
:disabled="pushing || !lastTaskId"
@click="pushToPythonQueue"
>
{{ pushing ? '启动中...' : '启动任务' }}
{{ pushing ? '启动中...' : '重新启动' }}
</button>
</div>
<p class="loading-msg">提交后自动识别 Excel 内容,再点「启动任务」即开始采集,进度和结果在右侧查看。</p>
<p class="loading-msg">提交后自动识别 Excel 内容并直接开始采集,进度和结果在右侧查看。若自动启动失败(例如不在桌面客户端内),单子保持「等待中」,可在右侧历史列表点「启动任务」。</p>
<div v-if="queuePushResult" class="queue-debug-card">
<div class="section-title queue-debug-title">启动结果</div>
@@ -125,6 +125,8 @@
<button type="button" class="btn-delete" @click="deleteTaskRecord(itemSource(item))">删除</button>
</template>
<template #history-item-actions="{ item }">
<button v-if="canStartTask(itemSource(item))" type="button" class="btn-run"
@click="startPendingTask(itemSource(item))">启动任务</button>
<button v-if="canDownload(itemSource(item))" type="button" class="download"
@click="downloadResult(itemSource(item))">下载</button>
<button v-if="canRetryTask(itemSource(item))" type="button" class="btn-retry"
@@ -149,19 +151,15 @@ import FileUploadZone from '@/shared/components/FileUploadZone.vue'
import ModuleTemplateDownload from '@/shared/components/ModuleTemplateDownload.vue'
import TaskCenterPanel from '@/shared/components/tasks/TaskCenterPanel.vue'
import type { TaskItemView, TaskStatCard } from '@/shared/components/tasks/types'
import { getPywebviewApi } from '@/shared/bridges/pywebview'
import { useExcelFileUpload } from '@/shared/composables/useExcelFileUpload'
import { useTaskProgressLoop } from '@/shared/composables/useTaskProgressLoop'
import { createCategorizedTimers } from '@/shared/utils/categorized-timers'
import { saveUrlWithProgress } from '@/shared/utils/download-progress'
import {
checkParseResult,
checkQueuePayload,
} from '@/shared/dispatch-guard'
import { checkParseResult } from '@/shared/dispatch-guard'
import { useCollectDataDispatch } from '@/shared/composables/useCollectDataDispatch'
import { passGuard } from '@/shared/dispatch-guard-ui'
import {
parseCollectData,
activateCollectDataTask,
getCollectDataDashboard,
getCollectDataHistory,
getCollectDataCountryPreference,
@@ -169,7 +167,6 @@ import {
getCollectDataTaskProgressBatch,
deleteCollectDataTask,
deleteCollectDataHistory,
failCollectDataTask,
type CollectDataDashboardVo,
type CollectDataHistoryItem,
type CollectDataParseVo,
@@ -428,6 +425,14 @@ async function submitCollect() {
return
}
ElMessage.success(`提交成功:任务 ${vo.taskNo || vo.taskId},识别 ${vo.acceptedRows ?? 0} 行有效数据`)
// 提交即启动:这里曾只做到「建单落库」就结束,启动是第二个按钮。用户点完提交就离开,
// 单子会永远停在等待中——ONLINE 通道服务端没有任何 PENDING 兜底会把它推起来(线上 33462 挂 20 小时)。
if (lastTaskId.value) {
await dispatchCollectDataTask(lastTaskId.value, {
taskNo: vo.taskNo, totalRows: vo.acceptedRows ?? 0, pageSize: vo.pageSize,
filters: buildFiltersPayload(),
})
}
await Promise.all([loadDashboard(), loadHistory()])
} catch (error) {
ElMessage.error(error instanceof Error ? error.message : '提交失败')
@@ -436,64 +441,41 @@ async function submitCollect() {
}
}
// 启动链本体在 useCollectDataDispatch(提交即启动、当前单重试、历史「等待中」单重启三条路共用同一出口)
const { dispatch: dispatchCollectDataTask, isStarting } = useCollectDataDispatch({
notify: (kind, text) => ElMessage[kind](text),
onBusyChange: (busy) => { pushing.value = busy },
onDispatched: (payload, queueSize) => {
queuePushResult.value = `已启动任务(排队中的任务数:${queueSize})`
queuePayloadText.value = JSON.stringify(payload, null, 2)
},
onStarted: (taskId) => progressLoop.add(taskId),
})
async function pushToPythonQueue() {
if (!lastTaskId.value) {
ElMessage.warning('请先提交采集任务')
return
}
const api = getPywebviewApi()
if (!api?.enqueue_json) {
ElMessage.warning('当前环境未提供任务队列能力')
return
}
pushing.value = true
let activated = false
try {
const payload = {
type: 'collect-data-run',
ts: Date.now(),
data: {
taskId: lastTaskId.value,
taskNo: lastParseVo.value?.taskNo,
taskType: 'collect-data',
totalRows: lastParseVo.value?.acceptedRows ?? 0,
pageSize: lastParseVo.value?.pageSize ?? 50,
filters: buildFiltersPayload(),
},
}
// 先校验再激活:拦下来时任务还是 PENDING,不需要回滚成 FAILED
const guard = checkQueuePayload(payload, {
expectedType: 'collect-data-run',
requiredDataKeys: ['taskId', 'pageSize'],
nonEmptyObjectKeys: ['filters'],
})
if (!(await passGuard(guard))) return
await activateCollectDataTask(lastTaskId.value)
activated = true
const result = await api.enqueue_json(payload)
if (!result?.success) {
throw new Error(result?.error || '启动失败')
}
queuePushResult.value = `已启动任务(排队中的任务数:${result.queue_size ?? '-'})`
queuePayloadText.value = JSON.stringify(payload, null, 2)
if (lastTaskId.value) {
progressLoop.add(lastTaskId.value)
}
ElMessage.success('已启动任务')
await loadDashboard()
} catch (error) {
if (activated && lastTaskId.value) {
try {
await failCollectDataTask(lastTaskId.value, error instanceof Error ? error.message : 'Python queue dispatch failed')
} catch {
/* 保留原始入队错误 */
}
}
ElMessage.error(error instanceof Error ? error.message : '启动失败')
await Promise.all([loadDashboard(), loadHistory()])
} finally {
pushing.value = false
}
const vo = lastParseVo.value
if (await dispatchCollectDataTask(lastTaskId.value, {
taskNo: vo?.taskNo, totalRows: vo?.acceptedRows ?? 0, pageSize: vo?.pageSize,
filters: buildFiltersPayload(),
})) await Promise.all([loadDashboard(), loadHistory()])
}
// filters 取服务端从 request_json 回传的那份、不取界面当前值,否则「重新启动」会悄悄改掉这一单的采集范围;
// pageSize 历史 VO 里没有(它是 parse 的返回字段),走出厂 50:它只决定采集端每次拉多少行明细,不改采集范围。
async function startPendingTask(item: CollectDataHistoryItem) {
if (!item.taskId) return
if (await dispatchCollectDataTask(item.taskId, {
taskNo: item.taskNo, totalRows: item.totalRows ?? 0, filters: item.filters,
})) await Promise.all([loadDashboard(), loadHistory()])
}
function canStartTask(item: CollectDataHistoryItem | null | undefined): boolean {
return Boolean(item?.taskId) && normalizeTaskStatus(item as CollectDataHistoryItem) === 'PENDING'
&& !isStarting(item?.taskId as number)
}
/**
@@ -624,7 +606,7 @@ async function loadHistory() {
const s = (it.taskStatus || '').toUpperCase()
return s === 'SUCCESS' || s === 'FAILED'
})
// 仅轮询已入 Python 队列的 RUNNING 任务;PENDING 任务等待用户主动推送。
// 仅轮询已入 Python 队列的 RUNNING 任务;PENDING 单由提交即启动接手,启动失败时在历史行出「启动任务」。
const seenTaskIds = new Set<number>()
for (const item of running) {
if (item.taskId) {
@@ -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 }
}
@@ -0,0 +1,68 @@
// COLLECT_DATA 的启动链判据(跨两个文件:界面入口在 BrandCollectDataTab.vue,启动链本体在 useCollectDataDispatch.ts)。
// 线上 33462 建单后 20 小时无人认领(updated_at 与 created_at 逐字相同、receivedRows=0),取证结论是:
// ONLINE 通道的 PENDING 没有任何服务端兜底会把它推起来(StaleTaskRepairService 明确跳过 PENDING、
// finalizeStaleTasks 只扫 RUNNING、TaskResumeService 只处理 FAILED),唯一能翻成 RUNNING 的动作是前端发
// activate——而它当时绑死在「本次会话刚 parse 出来的 lastTaskId」上。用户点完提交就离开,这一单在界面上
// 就再没有任何入口能启动(同批 33103 已挂 6 天)。
// 跑法:npm test
import { test } from 'node:test'
import assert from 'node:assert/strict'
import { fileURLToPath } from 'node:url'
import { dirname, resolve } from 'node:path'
import { readFileSync } from 'node:fs'
const here = dirname(fileURLToPath(import.meta.url))
const TAB = readFileSync(
resolve(here, '../src/pages/brand/components/BrandCollectDataTab.vue'), 'utf8')
const CHAIN = readFileSync(
resolve(here, '../src/shared/composables/useCollectDataDispatch.ts'), 'utf8')
/** 取函数体:从声明行到与之配对的行首 `}`(两个文件都是 0 缩进收尾) */
function bodyOf(source: string, signature: string): string {
const start = source.indexOf(signature)
assert.ok(start >= 0, `源码里找不到 ${signature}`)
const end = source.indexOf('\n}', start)
assert.ok(end > start, `${signature} 的行尾闭合括号没找到`)
return source.slice(start, end)
}
test('提交即启动:submitCollect 成功后必须自己走启动链,不得只提示用户去点第二个按钮', () => {
const submit = bodyOf(TAB, 'async function submitCollect()')
assert.match(submit, /await dispatchCollectDataTask\(\s*lastTaskId\.value/,
'submitCollect 不再自动启动=33462 那个「提交完就永远等待中」的形状回来了')
// 启动所需的行数字段必须从 parse 返回里带进 payload,不能悄悄填 0
assert.match(submit, /totalRows:\s*vo\.acceptedRows \?\? 0/)
assert.match(submit, /pageSize:\s*vo\.pageSize/)
})
test('启动链只有一个出口:activate 只在 composable 的 dispatch 内出现,界面层不得自己拼', () => {
const calls = CHAIN.split('\n').filter((line) => /activateCollectDataTask\(/.test(line))
assert.equal(calls.length, 1, `activate 在启动链里出现 ${calls.length} 处:多出来的那份绕过了入队失败回滚`)
assert.ok(bodyOf(CHAIN, 'async function dispatch').includes('await activateCollectDataTask(taskId)'))
assert.ok(bodyOf(CHAIN, 'async function dispatch').includes('checkQueuePayload'), '启动链必须自带前置校验')
// 界面层只能拿到 dispatch 的结果,不得绕过它直接激活或直接把单置 FAILED
for (const symbol of ['activateCollectDataTask(', 'failCollectDataTask(', 'enqueue_json(']) {
assert.ok(!TAB.includes(symbol), `界面层出现了 ${symbol}:那是一条不走共用校验与回滚的第二启动路`)
}
})
test('历史「等待中」单必须有启动入口,且按建单存下的条件重启', () => {
assert.match(TAB, /v-if="canStartTask\(itemSource\(item\)\)"[^>]*>\s*启动任务/,
'历史行没有「启动任务」按钮=离开提交屏就再无入口,33462 那类单子继续悬挂')
assert.match(bodyOf(TAB, 'function canStartTask'), /=== 'PENDING'/,
'启动入口必须只对 PENDING 出,RUNNING/SUCCESS/FAILED 出它是错的')
const startPending = bodyOf(TAB, 'async function startPendingTask')
assert.match(startPending, /filters:\s*item\.filters/,
'重新启动必须复用服务端从 request_json 回传的那份 filters;改用界面上当前选的值=悄悄改掉这一单的采集范围')
assert.doesNotMatch(startPending, /filters:\s*buildFiltersPayload\(\)/, '同上:历史行重启不读界面值')
})
test('缺桌面壳时不得静默 return:文案要点名「等待中」与下一步动作', () => {
const dispatch = bodyOf(CHAIN, 'async function dispatch')
const guardIndex = dispatch.indexOf('!api?.enqueue_json')
assert.ok(guardIndex >= 0, '启动链不再检查 pywebview 队列能力')
const segment = dispatch.slice(guardIndex, dispatch.indexOf('return false', guardIndex))
assert.match(segment, /等待中/, '只说「环境不支持」会把用户引去等一个不会来的自动重试——这一单不会自己开始跑')
assert.match(segment, /启动任务/, '必须点名可补救的那一步')
})