坯料导入\\\"静默成功\\\":一个没接返回值的 await 坑了谁

测试同学甩来一条反馈:坯料管理页面上传 Excel、点确认,页面不报错,列表不刷新,但数据就是没进去。后端日志里甚至看不到异常,导入接口正常返回 200。复现三次,三次都一样。

原代码只发了请求,没接返回值

打开 src/views/billet/components/billet-import.vue,定位到 handleConfirm 函数(git diff 行号 121 附近),原代码大致长这样:

formData.append('file', fileList.value[0].raw as File)
submitLoading()
try {
  await billetImport(formData)
  // 完了,没了
} finally {
  submitFinish()
}

await billetImport(formData) 把响应整个丢掉了。后端其实返回了结构化错误信息——res.data.errorDownloadPath(错误文件下载地址)和 res.data.tip(可读的失败原因),但前端压根没接,用户看到的只是"转圈结束、什么都没发生"。

更坑的是 emits('getTableList') 也压根没调用,列表不刷新,用户自然以为导入成功了。

最小补丁:一个文件、四处改动

排查完调用链后结论很清楚:后端逻辑没问题,错误字段已经在响应体里了,缺的只是前端"接住并展示"这一步。所以只改前端这一个文件,不动后端。

实际 diff 核心部分:

+        const res = await billetImport(formData)
+        emits('getTableList')
+        if (res.data?.errorDownloadPath) {
+            ElMessageBox({
+                title: '导入失败',
+                message: h('div', null, [
+                    h('div', null, res.data?.tip),
+                    h('button', { style: '...' }, '下载错误明细')
+                ])
+            })
+        }

四个关键点:

  • const res = await ... 接住返回值,不再丢弃
  • 无论成功失败都调 emits('getTableList'),保证列表状态同步
  • 用 res.data?.errorDownloadPath 做存在性判断(可选链),后端没返回该字段时不会抛 TypeError
  • 错误提示用 h() 渲染 ElMessageBox 的 message,塞进一个"下载错误明细"按钮,用户能直接拿到失败行的 Excel

为什么用 h() 而不是模板字符串?因为 ElMessageBox 的 message 参数在 Vue 3 里传 VNode 才能渲染交互组件,纯字符串只能展示文本,按钮就没了。

为什么不动后端

排查时翻了导入服务的日志,异常分支里已经把 errorDownloadPath 和 tip 塞进了响应体,HTTP 状态码维持 200——这是"业务级失败"而非"系统级错误"的设计,后端本身没 bug。

改后端的成本:要动导入服务的响应结构,回归测试范围扩到所有调用方。
改前端的成本:一个 .vue 文件,四处插入,review 十分钟内能过。

最小改动面在这儿很明确,不值得多碰一个服务。

可带走的几条教训

  • await 不等于"处理了"。 写了 await someApi(data) 却不用返回值,等价于加个 void。code review 时看到 await 后面既没赋值也没 .then(),直接问一句"返回值谁消费了?"
  • 业务失败返回 200 的接口,前端必须显式判断响应体里的错误字段。 别指望 HTTP 4xx/5xx 来兜底,200 不代表业务成功。
  • 导入/导出类功能,错误提示要给"看得到失败明细"的路径。 一个下载按钮比十行 toast 有用,用户需要知道哪几行、因为什么没进去。
  • 修 bug 先问最小改动面在哪。 这次从前端到后端的调用链上,缺口就在前端那行被丢弃的 res,补上即可,没必要动导入服务。

做自动化这几年,最耗时间的从来不是写代码,是摸清每个平台的脾气。

这篇里提到的坑,都是真金白银踩出来的。
如果你手上也有重复度很高的活儿——批量发布、数据搬运、有固定规则的机械操作
——可以在评论区说说你的场景,我看看能不能自动化掉。

posted @ 2026-11-08 05:22  钱栈up  阅读(7)  评论(0)    收藏  举报