You need to enable JavaScript to run this app. 如何处理下载类HTTP响应,文件不存在时在alert弹窗展示错误
优惠活动
大模型
产品
解决方案
定价
更多

如何处理下载类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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.15 23:54:08