Node.js使用Express实现服务端PDF下载未触发保存问题

问题表现 #

接口请求后PDF二进制内容直接在响应体返回，浏览器不弹出文件保存窗口，无法直接保存文件。

期望效果为点击下载后直接触发浏览器原生文件保存弹窗：
#

修复步骤 #

1. 修正后端冗余代码 #

res.download() 是Express封装好的下载方法，会自动设置正确的Content-Disposition: attachment响应头，无需手动重复设置头。手动设置反而可能因为文件名未做编码、格式不规范导致头解析失效。
将原有代码简化为：

const file_path = path.join(__dirname, '../PDF', category, `${itemName}.pdf`);
// 第二个参数可指定下载时展示的文件名，自动处理特殊字符、中文编码
res.download(file_path, `${itemName}.pdf`, (err) => {
  if (err) {
    res.status(500).send('文件下载异常');
  }
});

提示：如果服务前挂了Nginx等反向代理，需要检查代理配置，确认没有过滤、覆盖Content-Disposition响应头。

2. 修正前端请求方式 #

如果后端头设置完全正确但还是不触发弹窗，90%的同类问题都是前端请求方式错误：基本都是前端用了axios/fetch/AJAX方式请求接口——这类请求拿到的响应会直接交给JavaScript处理，浏览器不会触发原生下载行为。
根据业务场景选对应方案即可：

• 场景1：接口是GET请求、不需要额外带特殊请求头（比如单独的鉴权头）
  直接用浏览器原生导航触发请求，不要用AJAX：

  <!-- 方案1：a标签直接指向下载接口 -->
  <a href="/你的下载接口路径" target="_blank">下载PDF文件</a>
  

  // 方案2：JS直接跳转
  window.location.href = '/你的下载接口路径'
  

• 场景2：必须用POST请求、或者需要带自定义请求头（比如鉴权Token）
  用AJAX拿到二进制流后，前端手动生成Blob临时地址触发下载，以axios为例：

  axios.get('/你的下载接口路径', {
    responseType: 'blob', // 必须指定响应类型为二进制Blob
    headers: {
      Authorization: '你的鉴权Token'
    }
  }).then(res => {
    // 从响应头解析下载文件名，也可自定义
    const contentDisposition = res.headers['content-disposition'];
    const fileName = decodeURI(contentDisposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/)[1]);
    // 生成临时Blob链接
    const blob = new Blob([res.data], { type: 'application/pdf' });
    const tempUrl = window.URL.createObjectURL(blob);
    // 创建临时a标签触发下载
    const downloadLink = document.createElement('a');
    downloadLink.href = tempUrl;
    downloadLink.download = fileName;
    downloadLink.click();
    // 释放临时内存地址
    window.URL.revokeObjectURL(tempUrl);
  })
  

内容的提问来源于stack exchange，提问作者eoghks