Express中res.download返回文件数据未触发浏览器下载弹窗问题

核心原因 #

你看到的PK开头的二进制数据是APK文件的原始内容，浏览器没弹出下载窗口，大概率是因为前端用了AJAX/fetch这类异步请求方式——这类请求只会把响应数据返回给JS代码，不会自动触发浏览器的下载行为。另外也可以排查下后端的文件路径是否准确。

解决方案 #

方案1：改用a标签直接请求（最简单） #

把前端调用改成普通的链接跳转，比如：

<a href="/downloadFile" download>下载APK</a>

或者用JS触发a标签点击：

const a = document.createElement('a');
a.href = '/downloadFile';
a.download = 'myFile.apk'; // 可选，指定下载文件名
document.body.appendChild(a);
a.click();
document.body.removeChild(a);

方案2：如果必须用异步请求（比如需要先做权限校验） #

如果前端必须用fetch/AJAX，那需要手动处理响应数据，转成Blob后触发下载：

fetch('/downloadFile')
  .then(res => res.blob())
  .then(blob => {
    const url = URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'myFile.apk';
    a.click();
    URL.revokeObjectURL(url); // 释放内存
  })
  .catch(err => console.error('下载失败:', err));

方案3：确保后端文件路径正确 #

虽然你说myFile.apk和app.js同层级，但Node.js的工作目录可能不是app.js所在目录（比如从上级目录启动服务），建议用__dirname拼接绝对路径，避免路径问题：

const path = require('path');

app.get("/downloadFile",(req,res)=> {
    const filePath = path.join(__dirname, 'myFile.apk');
    res.download(filePath, function(error){
        if (error) {
            console.log("Error : ", error);
        } else {
            console.log("ok");
        }      
    });
});

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