Django无法渲染MEDIA目录下本地图片文件的问题求助

你的配置存在4处核心错误，按以下步骤逐一修改即可正常加载图片：

1. 修正settings.py配置 #

你当前的配置存在两个问题：

• DEFAULT_FILE_STORAGE参数用于指定文件存储后端类，不能填本地磁盘路径，你当前的赋值会直接导致文件存储逻辑异常，新手直接保留框架默认值即可，不需要手动修改该配置。
• MEDIA_ROOT是服务器本地存放媒体文件的绝对路径，需要和你实际存放文件的目录匹配。
  将相关配置修改为：

# 媒体文件本地存储根目录，对应你项目下的files/media目录
MEDIA_ROOT = BASE_DIR / 'files' / 'media'
# 浏览器访问媒体文件的URL前缀
MEDIA_URL = '/media/'
# 删除你原来写的DEFAULT_FILE_STORAGE = BASE_DIR  /'files' 这行错误配置

2. 修正urls.py的媒体文件路由 #

你最后拼接的静态路由前缀写的是's/'，和MEDIA_URL配置的/media/完全不匹配，Django不会处理/media/开头的文件请求。
将urls.py末尾的static配置修改为：

] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

注意：该路由配置仅在DEBUG=True的开发环境下生效，生产环境需要通过Nginx、Apache等Web服务器托管媒体文件，不要依赖Django本身处理静态文件请求。

3. 修正模板中的图片引用语法 #

你当前的模板写法存在两个错误：

• 不存在{{% MEDIA_ROOT %}}这种模板语法，且MEDIA_ROOT是服务器本地磁盘路径，绝对不能直接写在前端img的src属性中——前端需要的是浏览器可访问的URL，不是服务器本地路径。
• 你写的图片路径/images/ourlogo.png和实际存放的logo.png路径、文件名均不匹配。
  将模板中的img标签修改为：

<img src="{{ MEDIA_URL }}logo.png" alt="Logo" height="40">

如果是通过模型ImageField字段上传的文件，直接调用字段的.url属性获取访问地址即可，不需要手动拼接路径。

4. 路径一致性校验 #

修改完成后确认目标图片的实际存放路径为项目根目录/files/media/logo.png，和MEDIA_ROOT的配置完全对应，不要放错目录或写错文件名。

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