Django如何配置显示Media目录下多子文件夹的图片？

问题背景 #

在Django项目中，需要将图片分别上传到blog/media/reviews_images和blog/media/reviews_miniatures_images两个子文件夹，用于文章展示和列表缩略图。目前仅能将其中一个文件夹设为MEDIA_ROOT来正常显示图片，另一个无法通过MEDIA_URL访问，希望通过统一的MEDIA_URL访问所有子文件夹下的图片。

核心解决方案 #

将MEDIA_ROOT指向所有子文件夹的父目录（即blog/media），让所有子文件夹都处于MEDIA_ROOT的管辖范围内，这样Django的静态文件服务就能通过MEDIA_URL映射到所有子文件夹。

1. 修正settings.py配置 #

把MEDIA_ROOT改为最上层的media目录，确保所有子文件夹都在该路径下：

# settings.py
MEDIA_ROOT = os.path.join(BASE_DIR, "blog/media")
MEDIA_URL = '/media/'

2. 优化models.py的存储配置 #

提供两种可选方案，推荐使用更简洁的upload_to参数：

方案一：使用upload_to（推荐）

无需手动创建FileSystemStorage，直接通过upload_to指定子文件夹：

# models.py
class ReviewsImages(models.Model):
    image = models.ImageField(upload_to="reviews_images")
    description = models.CharField(max_length=50)

class ReviewsMiniaturesImages(models.Model):
    miniature_image = models.ImageField(upload_to="reviews_miniatures_images")
    description = models.CharField(max_length=50)
    game_title = models.CharField(max_length=50)

    def __str__(self):
        return f"{self.game_title} {self.description}"

方案二：调整FileSystemStorage路径

如果坚持使用FileSystemStorage，将location改为相对MEDIA_ROOT的子文件夹名（避免硬编码绝对路径）：

# models.py
from django.conf import settings
import os

fs_reviews_images = FileSystemStorage(location=os.path.join(settings.MEDIA_ROOT, "reviews_images"))
class ReviewsImages(models.Model):
    image = models.ImageField(storage=fs_reviews_images)
    description = models.CharField(max_length=50)

fs_reviews_minature_images = FileSystemStorage(location=os.path.join(settings.MEDIA_ROOT, "reviews_miniatures_images"))
class ReviewsMiniaturesImages(models.Model):
    miniature_image = models.ImageField(storage=fs_reviews_minature_images)
    description = models.CharField(max_length=50)
    game_title = models.CharField(max_length=50)

    def __str__(self):
        return f"{self.game_title} {self.description}"

3. 保持urls.py配置不变 #

只需要保留一次static映射，因为所有子文件夹都已在MEDIA_ROOT范围内：

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

urlpatterns = [
    path("admin/", admin.site.urls),
    path("", views.HomeView.as_view(), name="home"),
    path("reviews", views.ReviewsListView.as_view(), name="reviews"),
    path("reviews/article/<pk>", views.ReviewsDetailView.as_view(), name="reviews-detail")
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

4. 模板引用无需修改 #

原模板写法可正常使用，ImageField的url属性会自动生成包含子文件夹的完整路径：

<img src="{{ MEDIA_URL }}{{ review.review_minature_image.miniature_image }}" class="card-img-top"
     alt="{{ review.review_minature_image.description }}">

原方案无效原因 #

Django的static()函数仅支持为一个URL前缀映射一个根目录，无法直接指定多个目录。因此必须让所有需要访问的子文件夹归属于同一个MEDIA_ROOT，才能通过MEDIA_URL访问到所有子文件夹下的资源。

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