使用Multer时res.download()无法触发浏览器下载弹窗的问题

可能的问题点及对应解决办法 #

1. fs.copyFile 未使用Promise版本 #

普通的fs.copyFile是回调式API，直接用await不会等待复制完成，会导致res.download尝试读取还未生成的文件，进而引发错误但未被正确处理。

解决： 使用fs.promises.copyFile替代：

// 替换原代码中的fs.copyFile
await fs.promises.copyFile(oldPath, newPath);

2. 相对路径的可靠性问题 #

使用./uploads或./downloads这类相对路径，会基于Node.js进程的启动目录解析，而非当前文件所在目录，可能导致文件找不到。

解决： 用__dirname拼接绝对路径：

import path from 'path';

// 在downloadFile函数中修改路径
const oldPath = path.join(__dirname, '../uploads', file._id.toString());
const newPath = path.join(__dirname, '../downloads', originalName);

3. 错误处理不完整 #

你的downloadFileHandler和downloadFile的catch块代码不完整，错误发生时可能没有向客户端返回任何响应，导致前端一直处于等待状态。

完善错误处理示例：

// downloadFileHandler中的catch块
catch (error) {
    let status = 500;
    if (error instanceof NotFoundError) {
        status = 404;
    } else if (error instanceof AuthorizationError) {
        status = 403;
    }
    res.status(status).json({ message: error.message });
}

// downloadFile中的catch块
catch (error) {
    // 重新抛出错误让上层handler处理
    throw error;
}

4. 前端请求方式错误 #

如果前端使用fetch、axios等AJAX方式发起请求，浏览器不会自动触发下载弹窗，因为AJAX不会处理Content-Disposition响应头。

解决：

• 前端改为直接跳转：window.location.href = '/download/xxx'
• 或者用window.open('/download/xxx')打开新窗口触发下载
• 如果必须用AJAX，需要手动处理响应：

  fetch('/download/xxx', { headers: { Authorization: 'Bearer token' } })
    .then(res => res.blob())
    .then(blob => {
        const url = URL.createObjectURL(blob);
        const a = document.createElement('a');
        a.href = url;
        a.download = '文件名';
        document.body.appendChild(a);
        a.click();
        URL.revokeObjectURL(url);
        document.body.removeChild(a);
    });
  

5. 文件读取权限或存在性问题 #

• 确保downloads目录存在，否则fs.copyFile会报错，可提前创建目录：

  await fs.promises.mkdir(path.dirname(newPath), { recursive: true });
  

• 检查原文件oldPath是否存在，可在复制前添加判断：

  try {
      await fs.promises.access(oldPath, fs.constants.F_OK);
  } catch {
      throw new NotFoundError('原文件不存在');
  }
  

内容的提问来源于stack exchange，提问作者Abel Prieto Martín