Django模板渲染媒体图片失败问题排查求助

嘿，我帮你梳理下这个Django模板里媒体图片不显示的问题，咱们从配置到模板一步步排查：

问题原因分析 #

看了你的配置，主要有这3个核心问题导致图片无法渲染：

• 静态文件核心应用被禁用：你把django.contrib.staticfiles在INSTALLED_APPS里注释掉了，这个组件是Django处理静态、媒体文件路由和访问的基础，没它的话媒体文件的访问逻辑会直接失效。
• 媒体文件的URL路由未配置：你的my_app/urls.py只配置了静态文件的路由映射，完全没处理MEDIA_URL到MEDIA_ROOT的关联，Django根本不知道该去哪里找媒体文件。
• 模板里的图片路径是错误的相对路径：当页面URL是/welcome/时，浏览器会把src='media/my_image.jpeg'解析成/welcome/media/my_image.jpeg，而不是你期望的/media/my_image.jpeg，路径完全跑偏了。

解决办法 #

1. 启用静态文件应用

打开settings.py，把注释掉的django.contrib.staticfiles恢复：

INSTALLED_APPS = [
    # 你的其他应用...
    'django.contrib.staticfiles',
]

2. 添加媒体文件的URL路由

修改my_app/urls.py，补充媒体文件的路由映射（注意要导入对应的模块）：

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

urlpatterns = [
    url(r'^welcome/', views.upload, name='upload'),
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) \
  + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

如果你的Django版本是2.0+，建议用path替代url，不过保持和现有代码风格一致也没问题

3. 修正模板里的图片路径

推荐用模板标签来生成正确的媒体路径，这样后续修改MEDIA_URL时不用改模板：

{% load static %}
<img src="{{ MEDIA_URL }}my_image.jpeg">

或者用更明确的get_media_prefix标签：

{% load static %}
<img src="{% get_media_prefix %}my_image.jpeg">

如果暂时不想用模板标签，也可以直接写绝对路径（不推荐，不够灵活）：

<img src="/media/my_image.jpeg">

额外检查项

• 确认my_image.jpeg确实存放在项目根目录的media文件夹下，路径为BASE_DIR/media/my_image.jpeg，注意文件名的大小写（Linux/macOS系统区分大小写）。
• 开发环境下不要执行collectstatic命令，这个命令是生产环境用来收集静态/媒体文件到统一目录的，开发时Django会直接从MEDIA_ROOT读取文件。

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