Django+Vue上传文件相关操作

本文详细介绍Django框架下文件上传的配置与实现过程,包括前端上传组件的使用、后台文件接收、同名文件覆盖策略、数据库与本地文件同步删除机制。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

同名文件覆盖及删除后台数据同时删除本地文件

Django后台上传文件

1)Django上传文件配置,在settings配置:

# 配置上传文件目录
MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, "media")

2)配置映射url

from django.views.static import serve
from django.conf import settings

urlpatterns = [
    ...,
    url(r'^media/(?P<path>.*)', serve, {"document_root": settings.MEDIA_ROOT}, name='media')
]

3)使用ivew上传组件实现上传头像 前端操作

<Upload
  ref="upload"
  type="drag"
  :before-upload="handleUpload"  // 上传之前的回调函数 返回true才表示成功
  :on-success="uploadSuccess"  // 上传成功的回调函数
  :on-error="uploadError"  // 错误回调函数
  :on-exceeded-size="handleMaxSize"  // 上传文件大小回调函数
  :max-size="2048" // 设置文件最大
  :data="data" // 其他上传数据
  :format="['jpg', 'png', 'jpeg']"  // 设置上传格式
  :on-format-error="handleFormatError2"  // 判断格式
  :action="api+'/api/uploadAvatar'"  // 上传的地方(接口)
>
  <div style="padding: 20px 0">
    <Icon type="ios-cloud-upload" size="52" style="color: #3399ff"></Icon>
    <p>Click or drag picture here to upload</p>
  </div>
</Upload>

handleUpload(file) {
  return true;
},
uploadSuccess(res) {
  //上传成功
  this.$Message.info(res.result.msg);
  if (res.result.code == 200) {
    this.$http
      .userLogin(this.author, this.pwd, this.getCookie("csrftoken"))
      .then(resp => {
        if (resp.result.code === "200") {
          var obj = {
            username: this.author,
            password: this.pwd,
            avatar: resp.result.avatar
          };
          sessionStorage.setItem("user", JSON.stringify(obj));
        }
      });
  }
  this.reload();
},
handleFormatError2() {
  this.$Message.error("文件格式不正确,请上传jpg、jpeg、png格式文件");
},
uploadError(error) {
  this.$Message.info(error);
},
handleMaxSize(file) {
  this.$Notice.warning({
    title: "超出文件大小限制",
    desc: "文件 " + file.name + " 太大,不能超过 2M。"
  });
},

4)后台接收前端文件操作

def upload_avatar(request):
    file = request.FILES.get('file', '')  # 获取文件 
    author = request.POST.get('author', '')  # 获取用户
    img_addr = '%s/person/%s' % (settings.MEDIA_ROOT, file.name)  # 指定文件上传路径及文件名
    # 写入文件
    with open(img_addr, 'wb') as f:
        for f_img in file.chunks():
            f.write(f_img)
    user = UserProfile.objects.get(Q(username=author) | Q(email=author))  # 获取用户对象
    user.portrait = 'person/'+file.name  # 修改用户头像
    user.save() # 保存
    data = {'code': '200', 'msg': '修改头像成功'}
    return JsonResponse({'result': data})

下载文件

from django.http import StreamingHttpResponse
import os
from django.utils.encoding import escape_uri_path  # 处理文件名文中文下载失败

def file_iterator(filename, chunk_size=512):
    with open(filename, 'rb') as f:
        while True:
            c = f.read(chunk_size)
            if c:
                yield c
            else:
                break

# 下载文件
def download_file_text(request, file_name):
    name = file_name.split('/')[-1]  # 显示在弹出对话框中的默认的下载文件名
    file_local = 'media/'+file_name  # 要下载的文件路径

    if not os.path.exists(file_local):
        return HttpResponse('File not found 404')

    response = StreamingHttpResponse(file_iterator(file_local))
    response['Content-Type'] = 'application/octet-stream'
    response['Content-Length'] = os.path.getsize(file_local)
    response['Content-Disposition'] = 'attachment;filename="{}"'.format(escape_uri_path(name))
    return response

同名文件覆盖

1)在app中新建stroage.py文件

from django.core.files.storage import FileSystemStorage
from django.conf import settings
import os

class OverwriteStorage(FileSystemStorage):
    def get_available_name(self, name, max_length=None):
        if self.exists(name):  # 上传文件同名则移除
            os.remove(os.path.join(settings.MEDIA_ROOT, name))
        return name

2)在models.py中引入

from interface.storage import OverwriteStorage

class DocumentDownload(models.Model):
    tag = models.ForeignKey(DocumentTag, related_name='tag_documents', verbose_name='文件类型', on_delete=models.CASCADE, null=True, blank=True)
    filename = models.CharField(max_length=100, verbose_name='文件名称')
    document = models.FileField(upload_to='documents', default='', verbose_name='文件', storage=OverwriteStorage())
    version = models.CharField(max_length=50, default='1.0.0', verbose_name='版本号')
    # equip_updated = models.BooleanField(default=True, verbose_name="根据设备可更新")
    updated = models.BooleanField(default=True, verbose_name="全局可更新文件")
    add_time = models.DateTimeField(verbose_name='添加时间', default=datetime.now)
    # 多对一(文件--类别)
    '''
    一个文件类型下面的所有文件:
    tag.tag_documents.all()
    '''
    
    class Meta:
        db_table = 'document_download'
        unique_together = ('tag', 'filename',)  # 联合唯一约束
        verbose_name = '文件管理'
        verbose_name_plural = verbose_name

    def __str__(self):
        return str(self.document)

这样就能在上传文件时同名文件覆盖。

删除数据库数据对应删除本地文件

1)在对应models文件

from django.db.models.signals import pre_delete
from django.dispatch.dispatcher import receiver

@receiver(pre_delete, sender=DocumentDownload)
def global_delete(sender, instance, **kwargs):
    # Pass false so FileField doesn't save the model.
    instance.document.delete(False)  # False 表示model不保存

pre_delete.connect(global_delete, sender=DocumentDownload)  # 关联信号

完成同时删除本地文件。

<think>好的,我现在需要解决用户的问题:如何用DjangoVue和华为云OBS实现大文件上传。首先,我得理清楚整个流程,然后分步骤思考每个部分怎么实现。 用户提到了Django作为后端,Vue作为前端,华为云OBS作为存储服务。大文件上传通常会遇到网络不稳定、文件过大导致上传失败的问题,所以可能需要分片上传和断点续的方案。华为云OBS支持分片上传,这点我记得没错的话,他们的API应该有相关的方法。 首先,前端部分,Vue需要实现文件分片。用户选择文件后,前端将文件切割成多个小块,每个分片单独上传。这里可能需要用到File API的slice方法。同时,为了管理上传进度和状态,可能需要一个任务队列,或者使用Promise.all来处理并发上传,但要注意浏览器并发限制,可能需要控制同时上传的分片数量。 然后,后端Django需要接收这些分片,可能需要对每个分片进行验证,比如校验MD5,确保分片正确。不过这里有个疑问,是否需要后端处理分片的上传,或者直接让前端上传到OBS?因为如果直接让前端上传到OBS,后端可能只需要生成预签名URL,这样可以减少服务器的负担。华为云OBS的预签名URL应该可以支持分片上传,这样前端直接和OBS交互,后端负责生成这些URL和完成上传后的处理。 这样的话,后端Django的角色可能主要是生成预签名URL,以及处理上传完成后的回调。比如,前端在上传所有分片后,通知后端,后端再向OBS发送完成分片上传的请求,合并所有分片。这样服务器不需要处理大量的文件输,减轻压力,同时更安全,因为文件直接到OBS,不经过服务器。 那具体步骤可能是这样的: 1. 前端选择文件,计算文件的MD5或其他哈希值作为唯一标识,用于后续分片标识和校验。 2. 前端向后端请求初始化分片上传,后端向OBS发起创建分片上传任务,获取Upload ID,并返回给前端。 3. 前端将文件分片,每个分片按顺序上传到OBS。对于每个分片,前端需要向后端获取该分片的预签名URL,然后直接PUT上传到OBS。 4. 所有分片上传完成后,前端通知后端完成上传,后端调用OBS的Complete Multipart Upload接口,合并分片。 5. 后端处理可能的回调,验证上传结果,返回最终的文件信息给前端。 这样,后端主要处理的是生成预签名URL、初始化上传和完成上传,而分片的上传由前端直接与OBS交互,效率更高,尤其是大文件的情况下。 接下来,需要确认华为云OBS的SDK是否支持生成预签名的分片上传URL。查阅华为云OBS文档,发现他们确实支持生成预签名URL,并且支持分片上传相关操作。Python SDK中有create_multipart_upload, upload_part, complete_multipart_upload等方法。所以Django后端可以使用这些方法来生成每个分片的预签名URL。 另外,前端需要处理分片的上传,可能需要使用axios或其他HTTP库来发送PUT请求到OBS的预签名URL。每个分片的上传顺序可能不重要,因为OBS会根据分片号进行合并,但需要确保每个分片的编号正确。 在安全性方面,预签名URL需要有有效期限,防止被恶意利用。同时,后端需要对用户进行身份验证,确保只有授权用户才能获取预签名URL。 可能的挑战包括分片大小的选择,通常OBS对分片大小有最小限制(比如5MB),需要前端分片时注意。另外,前端计算文件的哈希值可能比较耗时,尤其是大文件,需要考虑使用Web Worker或优化算法,避免阻塞主线程。 还有断点续的问题,前端需要记录已上传的分片,以便在上传中断后恢复时跳过已上传的部分。这可能需要本地存储,比如localStorage或IndexedDB,来保存上传状态。 总结下来,步骤大致如下: 1. 用户选择文件,前端计算文件哈希,向后端请求初始化上传获取Upload ID和分片信息。 2. 后端使用华为云OBS SDK创建分片上传任务,获取Upload ID,返回给前端。 3. 前端将文件分片,为每个分片向后端获取预签名URL。 4. 后端为每个分片生成预签名URL,前端直接上传分片到OBS。 5. 所有分片上传完成后,前端通知后端,后端调用OBS完成分片合并。 6. 处理回调,返回上传结果给前端。 这样设计的好处是后端压力小,文件直接到OBS,同时利用OBS的分片功能实现大文件上传。需要处理的关键点包括分片上传的预签名URL生成、前端分片逻辑、断点续的支持,以及错误处理。 可能还需要考虑文件上传进度的显示,前端需要跟踪每个分片的上传进度,并汇总显示总体进度。这可以通过监听每个分片的上传进度事件,然后计算总和来实现。 另外,华为云OBS可能有上传分片的最大数量限制,需要确保分片数量不超过限制。例如,OBS允许最多10000个分片,所以分片大小需要根据文件大小调整,比如每个分片至少5MB,这样最大支持约50GB的文件。如果文件更大,可能需要调整分片大小。 最后,测试各环节的稳定性,比如网络中断后能否恢复上传,分片上传失败后的重试机制,以及合并分片时的错误处理。</think>### Django + Vue + 华为云OBS实现大文件上传分步指南 --- #### **一、技术方案核心思路** 1. **分片上传**:将大文件切割为多个小分片(如5MB/片),避免单次请求超时。 2. **直OBS**:前端直接上传分片到华为云OBS,减轻服务器压力。 3. **预签名URL**:后端生成临时安全上传地址,控制权限和有效期。 4. **断点续**:记录已上传分片,支持中途断网后恢复。 --- #### **二、华为云OBS配置** 1. **创建桶(Bucket)** - 登录华为云控制台,创建OBS桶,设置存储类别(标准/低频)。 - 记录`Endpoint`(如`obs.cn-east-3.myhuaweicloud.com`)和`Bucket名称`。 2. **生成访问密钥** - 在“我的凭证”中获取`AK`(Access Key)和`SK`(Secret Key)。 --- #### **三、Django后端实现** ##### 1. 安装依赖 ```bash pip install django obs-python-sdk ``` ##### 2. 生成预签名URL(核心代码) ```python # views.py from obs import ObsClient def generate_presigned_url(request): ak = 'YOUR_AK' sk = 'YOUR_SK' endpoint = 'obs.cn-east-3.myhuaweicloud.com' bucket_name = 'your-bucket' # 初始化OBS客户端 obs_client = ObsClient(access_key_id=ak, secret_access_key=sk, server=endpoint) # 生成分片上传的Upload ID if request.method == 'POST': file_key = request.POST.get('file_name') resp = obs_client.createMultipartUpload(bucket_name, file_key) upload_id = resp.body['uploadId'] return JsonResponse({'upload_id': upload_id, 'file_key': file_key}) # 生成单个分片的预签名URL elif request.method == 'GET': upload_id = request.GET.get('upload_id') part_number = request.GET.get('part_number') file_key = request.GET.get('file_key') # 生成上传URL(有效期1小时) url = obs_client.createSignedUrl( 'PUT', bucket_name, file_key, expires=3600, headers={'Content-Type': 'application/octet-stream'}, queryParams={ 'partNumber': part_number, 'uploadId': upload_id } ) return JsonResponse({'url': url}) ``` ##### 3. 完成上传合并分片 ```python def complete_upload(request): if request.method == 'POST': upload_id = request.POST.get('upload_id') file_key = request.POST.get('file_key') parts = json.loads(request.POST.get('parts')) # 分片列表[{partNumber: 1, etag: '...'}] obs_client.completeMultipartUpload( bucket_name, file_key, upload_id, parts ) return JsonResponse({'status': 'success'}) ``` --- #### **四、Vue前端实现** ##### 1. 文件分片逻辑 ```vue <template> <input type="file" @change="handleFileSelect"> </template> <script> export default { methods: { async handleFileSelect(e) { const file = e.target.files[0]; const chunkSize = 5 * 1024 * 1024; // 5MB/片 const chunks = Math.ceil(file.size / chunkSize); // 1. 初始化上传任务 const { data: { upload_id, file_key } } = await axios.post('/api/init_upload/', { file_name: file.name }); // 2. 上传所有分片 const uploadedParts = []; for (let i = 0; i < chunks; i++) { const start = i * chunkSize; const end = Math.min(start + chunkSize, file.size); const blob = file.slice(start, end); // 获取分片预签名URL const { data: { url } } = await axios.get('/api/get_upload_url/', { params: { upload_id, part_number: i + 1, file_key } }); // 直OBS const { headers: { etag } } = await axios.put(url, blob, { headers: { 'Content-Type': 'application/octet-stream' } }); uploadedParts.push({ PartNumber: i + 1, ETag: etag }); } // 3. 通知后端合并分片 await axios.post('/api/complete_upload/', { upload_id, file_key, parts: uploadedParts }); } } } </script> ``` ##### 2. 进度显示优化 ```javascript // 使用axios拦截器跟踪进度 axios.interceptors.request.use(config => { if (config.url.includes('obs.myhuaweicloud.com')) { config.onUploadProgress = progressEvent => { const percent = Math.round((progressEvent.loaded / progressEvent.total) * 100); console.log(`分片 ${config.params.partNumber} 上传进度: ${percent}%`); }; } return config; }); ``` --- #### **五、关键问题处理** 1. **分片大小选择** - 华为云OBS要求分片范围:5MB ≤ 分片 ≤ 5GB - 建议分片大小:10~20MB(平衡网络效率和并发性能) 2. **断点续实现** - 前端通过`localStorage`记录已上传分片的`partNumber`和`ETag`。 3. **文件唯一性校验** - 后端可在初始化时校验文件MD5,避免重复上传。 --- #### **六、安全增强建议** 1. **预签名URL有效期**:建议设置为10~30分钟,防止URL泄露风险。 2. **服务端校验**:合并分片后,后端调用OBS接口校验文件完整性。 3. **HTTPS输**:OBS桶启用HTTPS,确保数据输加密。 --- #### **七、华为云OBS费用注意** - 分片上传会计费为`PutObject`请求次数(每分片一次)。 - 存储费用根据文件总大小计算(标准/低频存储不同定价)。 --- 通过以上步骤,可实现稳定的大文件上传方案,结合Django的管理能力、Vue的交互体验和华为云OBS的高可靠性。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值