【前端】【业务场景】【面试】在前端开发中,如何实现文件的上传与下载功能,并且处理可能出现的错误情况?

前端文件上传与下载攻略

本文目标:帮你快速掌握文件上传 & 下载的核心实现方式,并在常见出错场景下保持"优雅不崩溃"。


一、文件上传

1. 基础结构

html 复制代码
<input type="file" id="fileInput" />
<button id="uploadBtn">上传</button>

2. 核心脚本

javascript 复制代码
document.getElementById('uploadBtn').addEventListener('click', uploadFile);

async function uploadFile () {
  const file = fileInput.files?.[0];           // ① 是否选择文件
  if (!file) return alert('请先选择文件!');

  const formData = new FormData();
  formData.append('file', file);

  try {
    const res = await fetch('/upload', {       // ② 发请求
      method: 'POST',
      body: formData,
    });
    if (!res.ok) throw new Error(`HTTP ${res.status}`);

    const data = await res.json();             // ③ 处理业务结果
    alert(`上传成功:${data.filename}`);
  } catch (err) {
    console.error(err);
    alert(`上传失败:${err.message}`);          // ④ 兜底提示
  }
}
⏳ 重点错误防护
  1. 未选文件 :if (!file) ...。
  2. 网络/HTTP 错误 :!res.ok 判定 & 抛错。
  3. 接口业务错误 :后端自定义 code → 前端根据 data.code 决策 UI。
  4. 超大文件 / 类型不符 :后端校验 → 返回 413/415,前端同样走 !res.ok 分支。

二、文件下载

场景 1:文件已存在静态 URL

html 复制代码
<a href="/static/report.pdf" download="报告.pdf">下载报告</a>

场景 2:前端生成 / 动态获取文件

javascript 复制代码
async function downloadDynamic () {
  try {
    // ① 拿到二进制(示例:后台生成 excel)
    const res = await fetch('/export/excel');
    if (!res.ok) throw new Error(`HTTP ${res.status}`);

    const blob = await res.blob();             // ② 转 blob
    const url  = URL.createObjectURL(blob);    // ③ 临时链接

    // ④ 触发下载
    const a    = document.createElement('a');
    a.href     = url;
    a.download = 'data.xlsx';
    a.click();

    URL.revokeObjectURL(url);                  // ⑤ 释放内存
  } catch (err) {
    alert(`下载失败:${err.message}`);
  }
}
⚠️ 常见下载错误处理
错误场景 浏览器表现 前端防范思路
链接 404 / 403 浏览器提示/空白页 !res.ok 捕获 + 友好提示
权限不足 返回 401/403 跳登录页或提示"无权限下载"
内容空 / 后端异常 文件 0 B blob.size === 0 时提示并中断

三、实战加分 Tips

  1. 进度条

    javascript 复制代码
    const xhr = new XMLHttpRequest();
    xhr.upload.onprogress = e => {
      if (e.lengthComputable) {
        const percent = (e.loaded / e.total) * 100;
        console.log(`已上传 ${percent.toFixed(1)}%`);
      }
    };
  2. 多文件并发上传 :Array.from(fileInput.files).map(f => formData.append('files', f))。

  3. 拖拽上传 :监听 dragover / drop,获取 event.dataTransfer.files。

  4. 断点续传 :结合 Content-Range + 后端分片合并。

  5. 安全防护 :

    • 前端白名单校验 MIME / 后缀。
    • token/签名防盗链。
    • HTTPS 保障传输安全。

四、结语

实现文件上传与下载并不难,难的是在各种异常面前稳如老狗。

  • 上传要三查:文件、网络、后端业务。
  • 下载要三稳:合法链接、正确权限、完整内容。
相关推荐
奶油话梅糖8 分钟前
容器启停 2.5 毫秒:11 天 1,700 Star 的 Kiri,用一个 900 KB 的 PID 1 干掉了 runc 和 dockerd
前端·人工智能·rust
kyriewen14 小时前
编辑弹窗点了取消,列表里的数据怎么还是变了?
前端·javascript·人工智能
Karl_fang14 小时前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
谭光志15 小时前
如何让 AI 高效工作
前端·后端·ai编程
FRing0316 小时前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷16 小时前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
再吃一根胡萝卜16 小时前
DSH plugin 开发示例:五种插件形态完整代码整理
前端
Yk酱2284017 小时前
A2UI随笔-demo-01
前端
云起SAAS17 小时前
本地生活同城多商户商城系统源码源码 合伙人分红加区域代理加排队返现
前端·javascript·后端