pinia 通过单一 store action 封装导出全流程,含任务发起、进度轮询、状态更新与错误处理;定义 isexporting、exportprogress、exporttaskid、exporterror、exportresult 五个响应式字段,支持取消、自动清理及组件安全调用。

Pinia 管理数据导出任务的后台异步进度状态,核心在于把「任务发起、轮询/监听、进度更新、完成或失败处理」全部收束到一个 store 的 action 中,并配合响应式字段实时反映状态变化。不依赖外部全局变量或组件内临时 state,确保状态可追踪、可复用、可测试。
定义明确的进度相关 state 字段
在 store 中声明一组语义清晰的响应式字段,覆盖导出全生命周期:
- isExporting:布尔值,标识当前是否有导出任务正在运行(发起后为 true,结束无论成败都设为 false)
- exportProgress:数字(0–100),表示当前进度百分比;初始为 0,后端支持进度时动态更新,不支持则可固定为 0→100 的两阶段切换
- exportTaskId:字符串,后端返回的唯一任务 ID,用于后续轮询或取消操作
- exportError:字符串或 null,存放用户友好的错误提示(如“网络超时”“权限不足”),非技术堆栈
- exportResult:导出成功后的结果数据(如下载链接、文件名、记录数等),便于组件跳转或展示
用 async action 封装完整导出流程
导出通常分三步:① 提交导出请求获取 taskId → ② 定期轮询或监听进度 → ③ 收到完成信号后拉取结果或报错。全部写在一个 action 里,逻辑连贯、错误可控:
- action 声明为 async,统一用 await 处理每个 Promise,避免 .then() 混用导致 catch 断链
- 第一步调用封装好的 API(如 startExport(params)),拿到 taskId 后立即更新 exportTaskId 和 isExporting: true
- 第二步用 setInterval 或更优的 pollingWithAbort 函数轮询 getExportStatus(taskId);每次响应更新 exportProgress;若 status === 'failed',清空定时器并赋值 exportError
- 第三步当 status === 'completed',调用 fetchExportResult(taskId) 获取下载地址等,并写入 exportResult
- 全程包裹 try/catch,异常统一捕获并设置 exportError 和 isExporting: false
支持手动取消与自动清理
用户点击「取消导出」或组件卸载时,需中止轮询、释放资源:
- 在 store 中保存轮询定时器 ID 或 AbortController 实例(如 abortController)
- 提供独立的 cancelExport() action:调用 abortController.abort() 并清除定时器,重置 isExporting 和 exportProgress
- 在组件 onUnmounted 钩子中调用 cancelExport,防止内存泄漏或状态错乱
组件中安全使用与反馈
组件通过 storeToRefs 解构响应式字段,配合 v-if / v-show 控制 UI 状态:
- 按钮禁用态::disabled="isExporting"
- 进度条显示:
- 错误提示:v-if="exportError" {{ exportError }}
- 成功反馈:v-if="exportResult" 显示下载按钮或文案
- 调用导出时建议加 await:await exportStore.startExport(formValues),方便做后续逻辑(如弹窗关闭、路由跳转)











