From 088c9cace064c64dc1848955a92dcaf5a32a13ad Mon Sep 17 00:00:00 2001 From: "weicw1996@qq.com" Date: Sat, 26 Sep 2026 11:50:49 +0800 Subject: [PATCH] =?UTF-8?q?:bug:=20=E5=AF=BC=E5=85=A5=E5=A4=B1=E8=B4=A5?= =?UTF-8?q?=E6=97=B6=E6=98=BE=E7=A4=BA=E5=90=8E=E7=AB=AF=E4=B8=9A=E5=8A=A1?= =?UTF-8?q?=E6=8F=90=E7=A4=BA=EF=BC=8C=E4=B8=8D=E5=86=8D=E8=AF=AF=E6=8A=A5?= =?UTF-8?q?=E7=B3=BB=E7=BB=9F=E9=94=99=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 问题（用户实测反馈）：导入只有一个表头的空文件时，前端提示「系统错误」， 用户误以为系统崩溃；后端其实已返回明确文案（400 + 「导入数据不能为空」）。 根因（两处叠加）： 1) axios 错误分支 reject(new Error(error)) 把原始错误包装掉， error.response 丢失、message 退化成 [object Object]； 2) 导入接口统一用 responseType:'blob'，非 2xx 的响应体也是 Blob， 而 axios 错误分支不做解析，拿不到后端 msg。 修复： - src/axios.js：错误分支直接 reject 原始 axios 错误，保留 response； - src/utils/import-excel.js：新增 resolveErrorMessage，从错误响应的 Blob 中 解析后端 JSON 取 msg；解析不到时兜底为中文提示（不再暴露 「Request failed with status code xxx」这类英文技术文案）。 验证：vite build 通过；模拟真实响应体验证 400 + 空表场景， 提示由「系统错误」变为后端原文「未读取到数据行，请确认表头下方已填写内容」。 --- src/axios.js | 5 ++++- src/utils/import-excel.js | 30 +++++++++++++++++++++++++++++- 2 files changed, 33 insertions(+), 2 deletions(-) diff --git a/src/axios.js b/src/axios.js index cd29fa6..9064c7d 100644 --- a/src/axios.js +++ b/src/axios.js @@ -223,7 +223,10 @@ axios.interceptors.response.use( }, error => { NProgress.done(); - return Promise.reject(new Error(error)); + // 保留原始 axios 错误对象：下游（如导入失败明细解析）需要 error.response + // 读取响应体。若包装成 new Error(error)，response 会丢失、message 退化成 + // "[object Object]"，用户只能看到无意义的通用提示。 + return Promise.reject(error); } ); diff --git a/src/utils/import-excel.js b/src/utils/import-excel.js index 425d5df..2e5126e 100644 --- a/src/utils/import-excel.js +++ b/src/utils/import-excel.js @@ -28,6 +28,34 @@ const parseBlobJson = async blob => { return text ? JSON.parse(text) : {}; }; +/** + * 解析导入失败时的错误提示文案。 + * + * 背景：导入接口统一用 `responseType: 'blob'` 请求，因此**非 2xx 响应体也是 Blob**。 + * axios 的错误分支不做解析，直接 reject，`error.message` 只有 + * 「Request failed with status code 400」这类通用文案（或全局兜底的「系统错误」）， + * 用户会误以为系统崩了——而后端其实已返回了明确的中文业务提示（如「导入数据不能为空」）。 + * + * 这里补上这一步：从错误响应的 Blob 里取出后端 `msg`，取不到再退回通用文案。 + */ +const resolveErrorMessage = async error => { + const blob = error?.response?.data ?? error?.data; + if (blob instanceof Blob) { + try { + const result = await parseBlobJson(blob); + if (result?.msg) return result.msg; + } catch (ignored) { + // 响应体不是 JSON（如网关返回的 HTML 错误页），退回通用文案 + } + } + const fallback = error?.response?.data?.msg || error?.message; + // axios 的英文通用文案对用户没有意义，统一换成中文提示 + if (!fallback || /Request failed with status code/i.test(fallback)) { + return '导入失败，请检查导入文件后重试'; + } + return fallback; +}; + /** * 加工后端返回的导入失败明细 Excel。 * 若传入 failDetailDecorator（函数），则动态加载 exceljs 读取 blob 流， @@ -125,7 +153,7 @@ export const handleImportExcel = async (vm, option, column, businessName, onSucc option.onSuccess(res); } } catch (error) { - vm.$message.error(error.message || '导入失败'); + vm.$message.error(await resolveErrorMessage(error)); if (typeof option.onError === 'function') { option.onError(error); }