Django项目媒体图片无法加载求助（Admin上传后仅显示Alt文本）

核心问题：字段名不匹配 #

你的模型里定义的图片字段是posterImage，但模板里调用的是movie.image.url，字段名完全不符，这是图片无法加载的直接原因。

分步修复步骤 #

1. 修正模板中的字段引用 #

把movie.html里的{{ movie.image.url }}改成{{ movie.posterImage.url }}，确保和模型字段名一致：

{% for movie in movies %}
    <div class="carousel-item">
        <img src="{{ movie.posterImage.url }}" class="d-block w-100" alt="{{ movie.title }}">
        <div class="carousel-caption">
            <h5>{{ movie.title }}</h5>
        </div>
    </div>
{% endfor %}

2. 验证DEBUG模式配置 #

确保settings.py中DEBUG = True，因为你只有在DEBUG模式下才配置了media文件的URL映射。如果DEBUG为False，Django不会自动处理media文件的静态服务（生产环境需要用Nginx/Apache等第三方服务处理）。

3. 检查media目录权限与存在性 #

• 确认MEDIA_ROOT指向的media目录已创建：可以在settings.py中添加这行代码确保目录存在：

  os.makedirs(os.path.join(BASE_DIR, 'media'), exist_ok=True)
  

• 确保服务器进程对media目录有读写权限，避免上传的图片无法被读取。

4. 简化URL配置（可选） #

你在project/urls.py和app/urls.py都配置了media的静态服务，这会导致重复映射，建议只在project/urls.py中保留配置即可：

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

urlpatterns = [
    # 你的其他URL配置
    path('admin/', admin.site.urls),
    # ...
]

if settings.DEBUG:
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

验证步骤 #

1. 重启Django开发服务器
2. 进入Admin面板，确认电影的posterImage字段已正确上传图片
3. 刷新前端页面，检查图片是否正常加载

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