fix(brand): 更新后「在跑的任务列表」不再静默变空——桥迟到自动重试、拉取失败不删本地态
现场(用户 2026-10-22):点「立即更新」→ 闸门确认并等待 → 进程被 update.exe 替换、 WebView 整页重载。重载那一刻 pywebview 桥还没注入,getPywebviewApi() 返回的降级桥里 vc_ 方法数为 0,而变体采集页把「桥不在」画成「暂无变体采集任务」:loadTasks 四条出口 全是静默 return(无桥/并发中/无 uid/!success),空 catch 也一样;首拉只发一次, 60 秒轮询又被「列表里有活跃任务」反锁 ⇒ 撞空一次就永久空,除手点刷新没有出路。 另外两页是另一种"没掉":跟价 loadHistory 一次 catch 把列表清空,紧接的 syncPollingIdsWithHistory 把「history 没有 + 无快照」的 id 连 localStorage 快照一起删 (不可恢复);商品风险同型且更狠,连快照豁免都没有。更新的几十秒里进程已退、 新进程未起,任何一次 /history 失败或 401 都踩得到。 改法:新增 shared/bridges/bridge-list-state.ts(失败分类/可见文案/首拉重试驱动, 退避复用 getTaskPollBackoffMs,8 轮约 35 秒);变体采集页桥未就绪→重试到成功或次数 用尽,失败态写进空列表文案并给一次 ElMessage;跟价/商品风险加 historyLoadOk 守卫, 拉取失败不清列表、不结算、不删本地 id。静默 catch 棘轮 83→81(实测;本轮减 1, 另 1 处是此前台账未缩,已一并拉平并逐文件改小)。 门禁:npx vue-tsc --noEmit rc=0;npm test 905/905 全绿(含新增 7 例 tests/bridge-list-first-load-retry.test.ts,改前对旧代码真红)。
This commit is contained in:
@@ -0,0 +1,90 @@
|
||||
/**
|
||||
* 桌面桥任务列表的取回判据(客户端更新后「在跑的任务列表没掉」修复)。
|
||||
*
|
||||
* 客户端更新=进程被 update.exe 替换 + WebView 整页重载。这一瞬 `window.pywebview` 还没注入,
|
||||
* `getPywebviewApi()` 退化成不含任何 `vc_` 方法的降级桥,于是页面里那句
|
||||
* `if (!bridge?.vc_list_tasks) return` 把「桥还没起来」渲染成「暂无任务」;而列表轮询又被
|
||||
* 「列表里有活跃任务才启动」反锁——首拉撞上这个窗口 ⇒ 列表空 ⇒ 活跃任务恒 false ⇒
|
||||
* 轮询永不启动 ⇒ 这一页被钉死在空列表,除了手点刷新没有出路。
|
||||
*
|
||||
* 这里只收敛**无副作用的判据与首拉重试驱动**:败在哪一环、有没有可见文案、要不要接着试。
|
||||
* 计时器与页面状态由调用方注入,本模块不碰 window。
|
||||
*/
|
||||
|
||||
import { getTaskPollBackoffMs } from '../task-progress-config.ts'
|
||||
|
||||
/** 一次列表取回的结局:成功 / 桥未就绪 / 登录态未恢复 / 请求或后端失败 */
|
||||
export type BridgeListAttempt = 'ok' | 'bridge' | 'uid' | 'failed'
|
||||
|
||||
/** 首拉最多试几轮(含首次)。退避曲线复用任务轮询那一套:0.5s→1s→2s→4s→8s→10s 封顶,
|
||||
* 8 轮累计约 35 秒,覆盖客户端进程替换到页面可打桥的实测窗口。 */
|
||||
export const BRIDGE_LIST_FIRST_LOAD_MAX_ATTEMPTS = 8
|
||||
|
||||
/** 每种结局的用户可见文案;非 ok 一律不许空白呈现(静默 catch 棘轮同源口径)。 */
|
||||
const BRIDGE_LIST_HINTS: Record<Exclude<BridgeListAttempt, 'ok'>, string> = {
|
||||
bridge: '客户端正在启动或更新,任务列表暂时连不上,会自动重试…',
|
||||
uid: '登录态还没恢复,任务列表暂时取不到,请重新登录后再看',
|
||||
failed: '任务列表拉取失败,会自动重试',
|
||||
}
|
||||
|
||||
export function bridgeListHint(attempt: BridgeListAttempt): string {
|
||||
return attempt === 'ok' ? '' : BRIDGE_LIST_HINTS[attempt]
|
||||
}
|
||||
|
||||
/** 只有成功不必再试;其余三种都值得再试(桥会起来、登录态会补上、网络会恢复)。 */
|
||||
export function isRetryableBridgeListAttempt(attempt: BridgeListAttempt): boolean {
|
||||
return attempt !== 'ok'
|
||||
}
|
||||
|
||||
/** 第 attempts 次尝试(从 1 计)之后该等多久。 */
|
||||
export function bridgeListRetryDelayMs(attempts: number): number {
|
||||
return getTaskPollBackoffMs(Math.max(0, attempts - 1))
|
||||
}
|
||||
|
||||
export interface BridgeListFirstLoadOptions {
|
||||
/** 已尝试次数(含首次)的上限 */
|
||||
maxAttempts?: number
|
||||
/** 注入退避曲线(测试用) */
|
||||
delayMs?: (attempts: number) => number
|
||||
/** 注入等待:页面用 categorized-timers 的 sleep,卸载时随 scope 一起清掉 */
|
||||
sleep: (ms: number) => Promise<void>
|
||||
/** 组件已卸载/用户已切换:立即停止,不再续链 */
|
||||
isCancelled?: () => boolean
|
||||
/** 每轮结局回调(页面据此更新可见提示) */
|
||||
onAttempt?: (result: { attempt: BridgeListAttempt; attempts: number }) => void
|
||||
}
|
||||
|
||||
export interface BridgeListFirstLoadResult {
|
||||
attempt: BridgeListAttempt
|
||||
attempts: number
|
||||
/** 被调用方取消(组件卸载)时为 true:此时不代表列表真的取不到 */
|
||||
cancelled: boolean
|
||||
}
|
||||
|
||||
/**
|
||||
* 首拉驱动:把「只发一次就放弃」换成「重试到成功或次数用尽」。
|
||||
*
|
||||
* load() 必须自己把失败归成 'bridge' | 'uid' | 'failed' 并返回,不得抛(抛了这里不兜,
|
||||
* 免得把真 bug 吞成一次重试)。成功即停;失败按退避重试;取消即停且不算失败。
|
||||
*/
|
||||
export async function runBridgeListFirstLoad(
|
||||
load: () => Promise<BridgeListAttempt>,
|
||||
options: BridgeListFirstLoadOptions,
|
||||
): Promise<BridgeListFirstLoadResult> {
|
||||
const maxAttempts = options.maxAttempts ?? BRIDGE_LIST_FIRST_LOAD_MAX_ATTEMPTS
|
||||
const delayMs = options.delayMs ?? bridgeListRetryDelayMs
|
||||
let attempts = 0
|
||||
let attempt: BridgeListAttempt = 'bridge'
|
||||
while (attempts < maxAttempts) {
|
||||
if (options.isCancelled?.()) {
|
||||
return { attempt, attempts, cancelled: true }
|
||||
}
|
||||
attempt = await load()
|
||||
attempts += 1
|
||||
options.onAttempt?.({ attempt, attempts })
|
||||
if (!isRetryableBridgeListAttempt(attempt)) break
|
||||
if (attempts >= maxAttempts) break
|
||||
await options.sleep(delayMs(attempts))
|
||||
}
|
||||
return { attempt, attempts, cancelled: false }
|
||||
}
|
||||
Reference in New Issue
Block a user