Django问题：使用ModelForm无法创建并保存对象

Hey there, let’s dig into why your VideoFile object isn’t saving properly with ModelForm. I’ve hit similar snags before, so here are the most common fixes to walk through:

1. Check Your Form’s enctype Attribute (Critical for File Uploads) #

If your HTML form doesn’t include enctype="multipart/form-data", Django won’t process the uploaded file at all—request.FILES will be empty, and your form will fail validation silently.

Make sure your template’s form tag looks like this:

<form method="POST" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">Upload Video</button>
</form>

2. Debug Form Validation Errors #

The first thing to do is see why form.is_valid() is returning False. Add some debugging to your view to reveal the errors:

def add_video(request):
    if request.method == "POST":
        form = VideoCreateForm(request.POST, request.FILES)
        if form.is_valid():
            instance = form.save()
            # Add success logic here (e.g., redirect)
            return redirect('video_list')  # Replace with your URL name
        else:
            # Print errors to console for debugging
            print(form.errors)
    else:
        form = VideoCreateForm()
    return render(request, 'your_upload_template.html', {'form': form})

You can also display errors directly in your template by adding {{ form.errors }} somewhere near the form—this will show you exactly which fields are failing (e.g., invalid file extension, missing required data).

3. Verify Your File Extension Validator #

Your validate_file_extension function might be misconfigured. Double-check that it’s correctly checking for valid video formats and raising a ValidationError when needed. Here’s a robust example you can use as a reference:

from django.core.exceptions import ValidationError
import os

def validate_file_extension(value):
    ext = os.path.splitext(value.name)[1].lower()
    valid_extensions = ['.mp4', '.mov', '.avi', '.mkv', '.flv']
    if ext not in valid_extensions:
        raise ValidationError("Only video files are allowed (MP4, MOV, AVI, MKV, FLV).")

4. Confirm MEDIA Settings Are Correct #

Django needs proper configuration to handle file uploads. In your settings.py, ensure you have these lines:

import os

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
MEDIA_URL = '/media/'

For development, you also need to add media file serving to your urls.py:

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    # Your existing URL patterns here
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

Without this, Django can’t save files to the correct directory, or you won’t be able to access them after upload.

5. Check Directory Permissions #

If you’re on a Linux/macOS server, ensure the media/video/ directory has write permissions for the user running your Django app (usually www-data for Apache/Nginx, or your local user for development). You can fix this with:

sudo chown -R www-data:www-data /path/to/your/project/media
sudo chmod -R 755 /path/to/your/project/media

Start with the enctype check first—it’s the most common culprit for file upload failures. If that’s not it, use form.errors to pinpoint the exact issue.

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