后台下载:获取响应头文件名

动态文件名下载实现方案

硬编码文件名的弊端

硬编码文件名在实际项目中存在明显缺陷:

  • 无法处理动态生成的文件名(如包含时间戳或服务器节点名)
  • 后端更了解导出数据的业务语义,适合由后端命名
  • 后端生成的唯一序列号可避免本地文件重名冲突
拦截器信息丢失问题

如果是已经开发完成的项目,通常Axios拦截器通常会直接返回res.data,导致响应头中的Content-Disposition字段丢失。解决方案是引入某个变量skipInterceptor配置,允许特定接口跳过拦截器处理。

核心实现步骤
  • 通常需要对拦截器做一些改造,比如:

请求封装改造

javascript 复制代码
service.interceptors.response.use(
  async (response) => {
    const config = response.config;
    
    if (config.skipInterceptor) {
      return response;
    }
    
    const { data } = response;
    if (response.request.responseType === 'blob' || response.request.responseType === 'arraybuffer') {
      return data;
    }
    
    return data;
  }
);

使用示例:

文件名解析工具

javascript 复制代码
function getRawFileName(header) {
  if (!header) return 'download';
  const match = header.match(/filename="?([^"]+)"?/);
  const rawName = match ? match[1] : 'download';
  try {
    return decodeURIComponent(rawName);
  } catch (e) {
    return rawName;
  }
}

业务层调用处理

javascript 复制代码
const handleExport = async (payload) => {
  try {
    const res = await exportApiLogList(payload);
    
    if (res.data.type === 'application/json') {
      const text = await res.data.text();
      const errorData = JSON.parse(text);
      Message.error(errorData.msg || '导出失败');
      return;
    }
    
    const disposition = res.headers['content-disposition'] || '';
    const fileName = getRawFileName(disposition);
    
    const blob = new Blob([res.data], { type: res.data.type });
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = fileName;
    document.body.appendChild(a);
    a.click();
    
    window.URL.revokeObjectURL(url);
    a.remove();
  } catch (err) {
    console.error('下载流程异常', err);
  }
};
注意事项:主要需要看的内容

跨域Headers限制

后端需在响应头中显式暴露Content-Disposition:

复制代码
Access-Control-Expose-Headers: Content-Disposition

本地环境调试限制

由于浏览器策略和开发环境代理的影响,本地服务可能无法获取文件名。建议在真实测试环境或生产环境下验证。

内存管理优化

使用URL.createObjectURL创建的链接会占用内存,需手动调用window.URL.revokeObjectURL(url)释放资源。

错误处理机制

必须检查res.data.type是否为application/json,避免用户下载到错误信息文件。

相关推荐
IT_陈寒3 小时前
Redis那个过期删除策略,差点让我线上崩了
前端·人工智能·后端
jianqiang.xue3 小时前
Espressif-IDE进入维护模式:乐鑫把ESP32开发的宝押给VS Code
前端·css·ide
特创数字科技4 小时前
纯本地离线运行的文档脱敏工具(技术分享)
前端·驱动开发·python
心之语歌4 小时前
uni-app uts原生插件开发:uts 与 Kotlin 交互踩坑实录(附解决方案)
前端·后端
再吃一根胡萝卜4 小时前
DSH 插件数据链路:Host 管数据,Client 只管画
前端
feixing_fx4 小时前
CSS 变量(Custom Properties):构建可扩展的主题切换系统
前端·css·前端框架·html·css3
十有八七5 小时前
手搓 Agent(一):先有大脑——大模型只会做一件事
前端·人工智能·后端
锋行天下5 小时前
「踩坑实录」给 LangGraph Agent 接两个 FastMCP,我被 langchain 偷偷改了工具名
前端·人工智能·后端
跳跳的小星星6 小时前
自研组件】Vue2 + ElementUI 通用列表页封装 wkjp-list-page,一套配置搞定搜索、动态表格、分页、增删改
前端
tryCbest6 小时前
Vue3—— 第 18 篇:Vue 2 到 Vue 3 迁移指南——升级避坑全记录
前端·vue.js