如何在Django中创建支持多类型文件上传的模型字段？

一、模型层实现：用 FileField 并添加文件类型判断方法 #

直接使用 FileField 即可支持所有文件类型上传，额外添加一个辅助方法来判断文件类型，方便前端渲染不同组件：

from django.db import models
from mimetypes import guess_type

class Post(models.Model):
    # 单个字段接收所有文件类型，上传到 media/uploads/ 目录下
    media = models.FileField(upload_to='uploads/')
    created_at = models.DateTimeField(auto_now_add=True)

    def get_file_type(self):
        """判断文件类型，返回image/video/pdf/other"""
        mime_type, _ = guess_type(self.media.path)
        if not mime_type:
            return 'other'
        if mime_type.startswith('image/'):
            return 'image'
        elif mime_type.startswith('video/'):
            return 'video'
        elif mime_type == 'application/pdf':
            return 'pdf'
        return 'other'

二、解决前端报错：image field has no attribute file #

你遇到的错误大概率是模板变量调用错误，不要使用 {{ object.media.file }}，正确的文件访问路径是 {{ object.media.url }}。同时要根据文件类型渲染对应的标签，不能用 img 标签加载视频/PDF等非图片文件。

三、模板层渲染逻辑 #

根据文件类型分别渲染图片、视频、PDF预览或下载链接：

{% for post in posts %}
<div class="post-item">
    {% if post.get_file_type == 'image' %}
        <img src="{{ post.media.url }}" alt="上传图片" style="max-width: 100%;">
    {% elif post.get_file_type == 'video' %}
        <video controls style="max-width: 100%;">
            <source src="{{ post.media.url }}" type="{{ post.media.file.content_type }}">
            你的浏览器不支持视频播放
        </video>
    {% elif post.get_file_type == 'pdf' %}
        <embed 
            src="{{ post.media.url }}" 
            type="application/pdf" 
            width="100%" 
            height="600px"
        >
    {% else %}
        <a href="{{ post.media.url }}" download>
            下载文件：{{ post.media.name|slice:"-20:" }}
        </a>
    {% endif %}
</div>
{% endfor %}

四、必要的配置检查 #

1. settings.py 配置媒体文件路径：

MEDIA_ROOT = BASE_DIR / 'media'  # 本地存储路径
MEDIA_URL = '/media/'  # 浏览器访问前缀

2. urls.py 添加媒体文件路由（开发环境）：

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

urlpatterns = [
    # 你的其他路由配置
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

3. 表单提交需指定编码类型：
   如果用表单上传文件，form标签必须加 enctype="multipart/form-data"：

<form method="post" enctype="multipart/form-data">
    {% csrf_token %}
    {{ form.as_p }}
    <button type="submit">上传</button>
</form>

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