JavaScript无法直接通过Ajax触发下载并自定义文件名，但可用fetch+Blob+a标签模拟：获取二进制流→构造Blob→创建临时URL→设置a标签download属性→触发点击→释放URL。
JavaScript 中无法直接通过 Ajax（XMLHttpRequest 或 fetch）触发浏览器下载并自定义文件名，因为 Ajax 的响应默认被当作数据处理，不会触发下载行为，且浏览器出于安全限制，不允许 JavaScript 直接指定下载保存的文件名。但可以通过一些巧妙方式绕过限制，实现“类 Ajax 下载 + 自定义文件名”的效果。
用 fetch + Blob + a 标签模拟下载
这是目前最常用、兼容性好、能控制文件名的方法。核心思路是：用 fetch 获取二进制数据 → 构造 Blob → 创建临时 URL → 用带 download 属性的 a 标签触发下载，并设置 desired 文件名。
- 后端需支持返回文件原始二进制流（如 Content-Type: application/octet-stream），且最好在响应头中提供 Content-Disposition: attachment; filename="xxx.pdf"（虽前端可覆盖，但部分浏览器会优先采用该值）
- fetch 需设置 responseType 为 'blob'（fetch 默认不设 responseType，需显式用
res.blob()解析） - 创建 a 标签时，href 设为 URL.createObjectURL(blob)，download 属性设为你想要的文件名（注意：仅对同源 URL 或 blob:// 有效）
- 触发点击后，记得调用
URL.revokeObjectURL(url)释放内存
示例代码：
async function downloadFile(url, fileName) {
try {
const res = await fetch(url, {
method: 'GET',
// 如需携带 token 或 cookie，根据需要配置 credentials 和 headers
credentials: 'include'
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const blob = await res.blob();
const blobUrl = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = blobUrl;
a.download = fileName; // ✅ 这里指定自定义文件名
document.body.appendChild(a);
a.click();
document.body.removeChild(a);
URL.revokeObjectURL(blobUrl);
} catch (err) {
console.error('下载失败:', err);
}
}
// 调用
downloadFile('/api/report', '2024年度统计报表.xlsx');
后端配合：返回文件名建议头（提升兼容性）
虽然前端可强制设置 download 属性，但部分旧版 Safari 或某些企业环境浏览器仍依赖响应头中的 Content-Disposition。因此建议后端在返回文件时加上：
立即学习“Java免费学习笔记（深入）”；
Content-Disposition: attachment; filename*=UTF-8''%E6%8A%A5%E8%A1%A8.xlsx // 或兼容写法（ASCII 文件名） Content-Disposition: attachment; filename="report.xlsx"
这样即使前端未设置 download 属性，或用户右键另存为，也能获得正确名称。
注意跨域与凭证问题
如果下载接口是跨域的，需确保：
- 后端设置了 Access-Control-Allow-Origin（不能为 *，若需 credentials）
- 前端 fetch 中设置 credentials: 'include'（如需 Cookie 或认证头）
- 后端响应头包含 Access-Control-Allow-Credentials: true
- 若后端未允许跨域，fetch 会失败，此时只能改用 form 提交或 window.open（但无法自定义文件名）
替代方案：隐藏 form 提交（适用于简单 GET 请求）
当 fetch/Blob 不适用（如老 IE、严格 CSP 禁止 createObjectURL）时，可用动态表单提交：
- 创建隐藏 form，method="GET"，action 指向下载地址
- 添加 input[name="__filename"] 传参（供后端读取并设响应头）
- submit 触发下载（但实际文件名仍由后端决定，前端无法 runtime 控制）
此方式无法真正由前端指定文件名，仅作兜底，不推荐作为首选。
不复杂但容易忽略：download 属性只对同源或 blob URL 生效；Blob 方案在移动端 Safari 也支持良好；务必清理 object URL，避免内存泄漏。
