坯料导入\\\"静默成功\\\":一个没接返回值的 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,补上即可,没必要动导入服务。
做自动化这几年,最耗时间的从来不是写代码,是摸清每个平台的脾气。
这篇里提到的坑,都是真金白银踩出来的。
如果你手上也有重复度很高的活儿——批量发布、数据搬运、有固定规则的机械操作
——可以在评论区说说你的场景,我看看能不能自动化掉。

浙公网安备 33010602011771号