前端大文件上传实战：分片、断点续传与优化策略

注意：实际生产中建议限制并发数量（例如同时只发 3-5 个请求），防止占用过多带宽或触发服务器限流。

2. 断点续传

如果上传中途断开，用户肯定不希望重新上传。我们需要记录已上传的分片索引，下次加载时跳过这些分片。

class ResumableUploader extends ChunkUploader {
  constructor(file) {
    super(file);
    this.uploadedChunks = new Set();
  }

  async init() {
    // 询问服务端哪些分片已存在
    const response = await fetch(`/api/upload/status?filename=${this.file.name}`);
    const { uploadedChunks } = await response.json();
    this.uploadedChunks = new Set(uploadedChunks);
    
    // 可选：本地缓存进度，防止刷新丢失
    localStorage.setItem('uploadProgress', JSON.stringify([...this.uploadedChunks]));
  }

  async upload() {
    const chunks = Math.ceil(this.file.size / this.chunkSize);
    for (let i = 0; i < chunks; i++) {
      if (this.uploadedChunks.has(i)) {
        continue;
      }
      const start = i * this.chunkSize;
      const end = Math.min(start + this.chunkSize, this.file.size);
      const chunk = this.file.slice(start, end);
      await this.uploadChunk(chunk, i);
      this.uploadedChunks.add(i);
    }
    await this.mergeChunks();
    localStorage.removeItem('uploadProgress');
  }
}

3. 拖拽交互优化

原生 input 样式单一，支持拖拽能显著提升操作便捷性。结合 React Hooks 可以优雅地处理事件。

import { useCallback } from 'react';

function DragUpload({ onUpload }) {
  const handleDrop = useCallback((e) => {
    e.preventDefault();
    const files = Array.from(e.dataTransfer.files);
    files.forEach(file => onUpload(file));
  }, [onUpload]);

  const handleDragOver = useCallback((e) => {
    e.preventDefault();
  }, []);

  return (
    <div className="drag-upload" onDrop={handleDrop} onDragOver={handleDragOver}>
      <p>拖拽文件到此处上传</p>
      <input type="file" multiple onChange={(e) => {
        Array.from(e.target.files).forEach(file => onUpload(file));
      }} />
    </div>
  );
}

最佳实践清单

除了核心逻辑，以下细节决定了方案的成熟度：

1. 实时进度监控：使用 XMLHttpRequest 的 upload.onprogress 获取更精确的字节级进度。
2. 文件类型校验：在上传前拦截不合规格式，节省流量和时间。
3. 图片预览：利用 URL.createObjectURL 实现本地预览，无需上传即可确认内容。

// ✅ 显示上传进度
const xhr = new XMLHttpRequest();
xhr.upload.onprogress = (e) => {
  const progress = (e.loaded / e.total) * 100;
  console.log(`${progress.toFixed(2)}%`);
};

// ✅ 图片预览
const preview = URL.createObjectURL(file);

// ✅ 文件类型检查
const allowedTypes = ['image/jpeg', 'image/png'];
if (!allowedTypes.includes(file.type)) {
  alert('不支持的文件类型');
  return;
}

总结

文件上传是前端开发中高频且关键的场景。不要满足于原生控件的基础功能，通过分片、断点续传和交互优化，不仅能解决性能瓶颈，更能体现产品的专业度。把上传过程从'等待'变成'可控'，才是用户体验的核心所在。