如何处理下载类HTTP响应,文件不存在时在alert弹窗展示错误
问题解决方案
1. 修复服务端状态码异常问题
文件不存在时响应状态码仍然为200属于服务端问题,按以下顺序排查:
- 用接口调试工具(Postman/ApiFox等)直接请求下载接口,确认文件不存在时返回的状态码是否为404
- 检查是否存在全局响应拦截中间件,统一将所有响应的状态码覆写为200
- 检查是否有优先级更高的路由规则提前匹配了该下载接口,导致没有走到返回404的逻辑
- 确认判断文件存在的路径配置正确,避免因为路径写错导致
fs.existsSync始终返回true
2. 实现正确的前端下载逻辑
原fetch代码没有区分响应类型,无论返回文件还是错误信息都统一转为文本,自然无法触发正常下载。优化后的逻辑如下:
async function getFile(url) { try { const response = await fetch(url); // 状态码为404时处理错误 if (response.status === 404) { const errMsg = await response.text(); alert(errMsg); return; } // 状态正常时将响应转为blob,触发下载 const blob = await response.blob(); // 从响应头获取原始文件名,也可以自定义 const contentDisposition = response.headers.get('Content-Disposition'); let fileName = 'file.pdf'; if (contentDisposition) { const nameMatch = contentDisposition.match(/filename="?([^"]+)"?/); if (nameMatch) fileName = decodeURIComponent(nameMatch[1]); } // 创建临时下载链接 const downloadUrl = window.URL.createObjectURL(blob); const tempLink = document.createElement('a'); tempLink.href = downloadUrl; tempLink.download = fileName; document.body.appendChild(tempLink); tempLink.click(); // 清理临时资源 window.URL.revokeObjectURL(downloadUrl); document.body.removeChild(tempLink); } catch (err) { console.error('下载请求异常:', err); alert('下载失败,请稍后重试'); } }
3. 替换原有触发方式
原表单提交会直接跳转页面,改为按钮绑定点击事件调用下载方法即可:
<button type="button" onclick="getFile('/HSE/Environnement/download/file')">Download</button>
内容的提问来源于stack exchange,提问作者MissKnacki
相关产品推荐
相关产品推荐

