You need to enable JavaScript to run this app. Django静态图正常,配置MEDIA_URL/MEDIA_ROOT后媒体图片不显示
优惠活动
大模型
产品
解决方案
定价
更多

Django静态图正常,配置MEDIA_URL/MEDIA_ROOT后媒体图片不显示

修复Django中media文件404的排查步骤
  • 第一步:校验MEDIA_ROOT的实际指向与文件存储位置是否匹配
    你的配置中PROJECT_ROOT是settings.py文件自身所在的目录,MEDIA_ROOT的设置逻辑是取settings.py所在目录的上一级,拼接media_root文件夹。这很容易出现路径错位:
    • 打开Django交互式shell,执行from django.conf import settings; print(settings.MEDIA_ROOT),打印出MEDIA_ROOT的绝对路径
    • 打开这个路径对应的实际文件夹,检查p2.jpg是否真的存在于此。多数404问题都源于:数据库中存的文件路径对应不上,比如你之前手动上传的文件放在了项目根目录的media文件夹,但MEDIA_ROOT实际指向了同级的media_root文件夹,路径不匹配自然无法返回文件。
  • 第二步:确认开发环境下的DEBUG开关状态
    你在urls.py中拼接的static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)逻辑,仅在settings.DEBUG = True时才会生效。如果当前DEBUG值被设为False,开发服务器不会自动处理media路径的请求,自然会返回404。
  • 第三步:确认media路由的加载位置
    检查拼接media静态路由的代码,是不是写在了项目根目录的主urls.py中。如果写在某个子应用的urls.py里,这部分路由不会被全局加载,会导致/media/路径没有对应的处理逻辑。
  • 第四步:校验数据库中存储的文件路径值
    在Django shell中执行查询,检查对应Product对象的图片字段实际存储值:
    # 替换成你自己的应用名称
    from your_app.models import Product
    product = Product.objects.get(id=你的产品ID)
    print(product.title_img.name)
    
    确认打印出的文件路径和前端请求的/media/p2.jpg是否匹配,避免出现字段存储路径和前端拼接路径不一致的问题。
  • 补充说明:如果是生产环境部署,上述urlpatterns拼接的media路由逻辑不会生效,需要通过反向代理服务器(如Nginx)配置/media/路径的映射规则,直接指向MEDIA_ROOT对应的物理目录。

内容的提问来源于stack exchange,提问作者Hashir

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 13:06:03