You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Django媒体文件无法预览:常规配置完成后仍无法加载图片求助

Django媒体文件无法预览排查方案

1. 校验运行模式与路由生效条件

static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) 仅在DEBUG = True的开发模式下生效,若当前DEBUG已设为False,该配置不会自动生效,需要使用Nginx、Apache等Web服务器单独托管MEDIA_ROOT对应的media目录。

2. 校验依赖导入完整性

确认项目根urls.py头部已导入所需依赖:

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

3. 校验文件存储与路径匹配

  • 确认上传的图片确实保存在MEDIA_ROOT配置的media目录下,文件名称、层级与word.image.url返回的路径完全匹配
  • 右键页面异常图片选择「检查」,查看渲染后的img标签src实际值,手动拼接服务地址访问该路径,判断返回错误类型:
    • 若返回404:路径与路由不匹配,可检查MEDIA_URL配置是否和路由前缀冲突
    • 若返回403:运行Django的进程无media目录读取权限,Linux环境可执行chmod -R 755 media赋权

4. 校验字段配置合理性

确认模型中image字段为models.ImageField类型,且已正确配置upload_to参数,上传流程无异常截断。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.06 22:18:03