Express路由实现文件下载+页面消息提示报错及解决方案咨询

你遇到的ERR_HTTP_HEADERS_SENT错误本质是HTTP协议的限制：一个请求只能对应一个完整的响应。res.download会自动发送文件下载的响应头（比如Content-Disposition）和文件内容，整个响应流程已经结束。此时再调用res.send，Express会尝试再次修改响应头，自然触发报错。

要实现“下载文件+页面显示消息”的需求，核心思路是拆分请求：让用户访问的路由返回显示消息的HTML页面，再通过页面内的逻辑触发单独的文件下载请求。以下是两种可行的实现方式：

方法1：返回提示页面并自动跳转下载接口 #

先创建一个显示提示的路由，再单独写一个处理文件下载的接口：

// 显示提示并触发下载的路由
router.get('/api/zip', AuthMiddleware, (req, res) => {
  res.send(`
    <!DOCTYPE html>
    <html>
    <head>
      <meta charset="UTF-8">
      <title>下载提示</title>
    </head>
    <body>
      <div style="text-align: center; margin-top: 50px;">
        <h1>文件下载已启动</h1>
        <p>如果下载未自动开始，请点击<a href="/api/zip/download">手动下载</a></p>
      </div>
      <script>
        // 页面加载后自动触发下载
        window.addEventListener('load', () => {
          window.location.href = '/api/zip/download';
        });
      </script>
    </body>
    </html>
  `);
});

// 单独的文件下载接口
router.get('/api/zip/download', AuthMiddleware, (req, res) => {
  res.download('./views/index.zip', 'index.zip', (err) => {
    if (err) {
      res.status(500).send(`无法下载文件：${err.message}`);
    }
  });
});

方法2：用iframe静默触发下载（页面不跳转） #

如果不想让页面跳转，可以用隐藏的iframe加载下载接口，同时页面显示提示消息：

router.get('/api/zip', AuthMiddleware, (req, res) => {
  res.send(`
    <!DOCTYPE html>
    <html>
    <head>
      <meta charset="UTF-8">
      <title>下载提示</title>
    </head>
    <body>
      <div style="text-align: center; margin-top: 50px;">
        <h1>文件正在下载中...</h1>
        <p>请稍等，文件将保存到您的下载目录</p>
      </div>
      <!-- 隐藏的iframe触发下载，不影响当前页面 -->
      <iframe src="/api/zip/download" style="display: none;"></iframe>
    </body>
    </html>
  `);
});

// 下载接口和方法1一致
router.get('/api/zip/download', AuthMiddleware, (req, res) => {
  res.download('./views/index.zip', 'index.zip', (err) => {
    if (err) {
      res.status(500).send(`下载失败：${err.message}`);
    }
  });
});

关键说明 #

• 拆分请求后，用户访问/api/zip时得到的是显示提示的HTML响应，而下载请求是由页面内的JS/iframe发起的另一个独立请求，两个响应互不干扰，不会触发头信息重复设置的错误。
• 注意文件路径的写法：你代码里的.\views\index.zip要改成./views/index.zip（用正斜杠，避免Windows路径转义问题）。

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