MongoEngine Django实现图片仅存MEDIA文件夹而非数据库的方法

核心思路 #

MongoEngine默认的ImageField会把图片二进制数据存在MongoDB的GridFS里，要实现Django式的本地MEDIA文件夹存储，需要：

• 用StringField存储图片的相对路径（而非二进制数据）
• 借助Django的文件处理工具完成上传、存储逻辑

步骤1：配置Django的MEDIA参数 #

在Django的settings.py里确保以下配置：

MEDIA_ROOT = BASE_DIR / 'media'
MEDIA_URL = '/media/'

同时在项目根的urls.py里添加MEDIA路由（仅开发环境用，生产环境需用Nginx等配置）：

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

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

步骤2：定义Company Document #

不用MongoEngine的ImageField，改用StringField存路径：

from mongoengine import Document, StringField

class Company(Document):
    name = StringField(required=True)
    url = StringField()
    # 存储图片相对路径，比如"companies/abc_logo.png"
    image = StringField(blank=True)

步骤3：处理图片上传逻辑 #

在视图里处理表单上传，把文件保存到MEDIA文件夹，然后把路径存入数据库：

from django.core.files.storage import default_storage
from django.core.files.base import ContentFile
from .documents import Company
import os

def add_company(request):
    if request.method == 'POST':
        name = request.POST.get('name')
        url = request.POST.get('url')
        image_file = request.FILES.get('image')
        
        company = Company(name=name, url=url)
        
        if image_file:
            # 定义存储子目录，避免文件混乱
            upload_dir = 'companies'
            # 生成唯一文件名（可选，防止重名覆盖）
            filename = f"{name.replace(' ', '_')}_{image_file.name}"
            file_path = os.path.join(upload_dir, filename)
            
            # 保存文件到MEDIA_ROOT
            default_storage.save(file_path, ContentFile(image_file.read()))
            # 把相对路径存入数据库
            company.image = file_path
        
        company.save()
        # 后续跳转或响应逻辑

步骤4：模板中显示图片 #

在Django模板里，通过MEDIA_URL拼接路径显示图片：

{% for company in companies %}
    <div>
        <h3>{{ company.name }}</h3>
        {% if company.image %}
            <img src="{{ MEDIA_URL }}{{ company.image }}" alt="{{ company.name }} logo">
        {% endif %}
    </div>
{% endfor %}

注意事项 #

• 生产环境不要用static路由处理MEDIA文件，需配置Web服务器（如Nginx）直接映射MEDIA目录
• 可以用Django的UUID生成唯一文件名，避免重名问题
• 要处理文件上传的验证（比如格式、大小），可以用Django的FileExtensionValidator或自定义验证逻辑

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