如何在Django Admin中批量上传大图片至GCS以规避超时？

1. 启用django-storages的可恢复分块上传 #

在settings.py中配置GCS存储的分块上传参数，让大文件自动拆分上传，避免单次请求超时：

GS_RESUMABLE_UPLOADS = True
GS_CHUNK_SIZE = 10 * 1024 * 1024  # 设为10MB每块，可根据网络情况调整

该配置会让django-storages调用GCS的可恢复上传API，将大文件拆分为多个小块分别上传，单块上传耗时短，不会触发10分钟超时限制。

2. 重写ModelAdmin保存逻辑拆分上传 #

通过自定义Admin的保存方法，先保存模型的非文件字段，再逐个处理图片上传，把大POST请求拆分为多个小请求：

from django.contrib import admin
from .models import YourModel
from django.core.files.storage import default_storage
import os

class YourModelAdmin(admin.ModelAdmin):
    def save_model(self, request, obj, form, change):
        # 先保存模型（暂不处理图片，避免一次性上传所有文件）
        obj.save(commit=False)
        
        # 遍历所有ImageField字段逐个上传
        for field_name in ['image1', 'image2', ...]:  # 替换为你的实际ImageField字段名
            file_obj = form.cleaned_data.get(field_name)
            if file_obj:
                # 单独上传当前图片到GCS
                file_path = f"your-model/{obj.id}/{file_obj.name}"
                default_storage.save(file_path, file_obj)
                # 更新模型字段为GCS存储路径
                setattr(obj, field_name, file_path)
        
        # 最终保存完整模型
        obj.save()

admin.site.register(YourModel, YourModelAdmin)

这种方式将原来一次上传所有文件的操作，拆分为多个独立的文件上传请求，每个请求仅处理一张图片，不会超过超时阈值。

3. 前端层面拆分上传（自定义Admin模板） #

修改Admin表单模板，用JavaScript实现图片先逐个上传到临时接口，再提交表单：

1. 先创建处理单张图片上传的视图：

from django.http import JsonResponse
from django.core.files.storage import default_storage

def upload_temp_image(request):
    if request.method == 'POST' and request.FILES.get('image'):
        image = request.FILES['image']
        temp_path = f"temp/{image.name}"
        default_storage.save(temp_path, image)
        return JsonResponse({'url': default_storage.url(temp_path)})
    return JsonResponse({'error': 'Invalid request'}, status=400)

2. 自定义Admin的change_form模板，添加JS逻辑：

{% extends "admin/change_form.html" %}
{% block extrahead %}
{{ block.super }}
<script>
document.addEventListener('DOMContentLoaded', function() {
    const form = document.getElementById('your-model-form');  // 替换为你的表单ID
    const imageFields = document.querySelectorAll('input[type="file"].image-field');  // 标记你的ImageField
    
    imageFields.forEach(field => {
        field.addEventListener('change', function() {
            const file = this.files[0];
            if (file) {
                const formData = new FormData();
                formData.append('image', file);
                
                fetch('/admin/upload-temp-image/', {  // 对应上面的视图URL
                    method: 'POST',
                    headers: {'X-CSRFToken': '{{ csrf_token }}'},
                    body: formData
                }).then(res => res.json()).then(data => {
                    // 将返回的GCS URL填入隐藏字段，替换原文件上传控件
                    const urlField = document.createElement('input');
                    urlField.type = 'hidden';
                    urlField.name = field.name;
                    urlField.value = data.url;
                    field.parentNode.appendChild(urlField);
                    field.style.display = 'none';
                });
            }
        });
    });
});
</script>
{% endblock %}

用户选择图片时，图片会先被逐个上传到GCS，表单提交时仅传递已上传的URL，不再携带大文件，彻底规避超时问题。

4. 结合异步任务处理上传（适合超大文件场景） #

如果图片上传耗时极长，可使用Celery异步处理：

1. 定义异步上传任务：

from celery import shared_task

@shared_task
def upload_image_to_gcs(temp_path, model_id, field_name):
    obj = YourModel.objects.get(id=model_id)
    file_obj = default_storage.open(temp_path)
    target_path = f"your-model/{model_id}/{os.path.basename(temp_path)}"
    default_storage.save(target_path, file_obj)
    setattr(obj, field_name, target_path)
    obj.save()
    default_storage.delete(temp_path)

2. 在ModelAdmin的save_model中调用异步任务：

def save_model(self, request, obj, form, change):
    obj.save(commit=False)
    for field_name in ['image1', 'image2', ...]:
        file_obj = form.cleaned_data.get(field_name)
        if file_obj:
            temp_path = f"temp/{file_obj.name}"
            default_storage.save(temp_path, file_obj)
            upload_image_to_gcs.delay(temp_path, obj.id, field_name)
    obj.save()

用户点击保存后，表单会快速提交，后台异步处理图片上传，不会触发超时。

内容的提问来源于stack exchange，提问作者Lawrence