Django中通过管理后台上传的图片无法显示，应如何排查解决？

问题根因 #

• 项目主路由没有配置媒体文件的访问规则，Django开发环境默认不会代理/media路径下的静态资源
• ImageField的upload_to参数配置重复，实际存储路径和访问路径不匹配
• 模板逻辑存在错误：遍历逻辑缺失、判断条件和实际使用的字段不对应
• 模板上下文默认没有注入MEDIA_URL变量，手动拼接路径会失效

修复步骤 #

1. 修改项目根目录下的urls.py（不是应用内的urls.py），添加媒体资源路由配置：

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

urlpatterns = [
    # 保留你原有的路由配置，比如后台路由、应用路由引入等
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

生产环境部署时需要用Nginx等代理/media路径，不需要加这段配置。

2. 修改models.py中的ImageField配置，避免路径重复：
   你已经在settings里指定了MEDIA_ROOT为项目根目录的media文件夹，upload_to不需要再写media，否则文件会实际存储到media/media/目录下，和访问路径不匹配：

# 可以改成存储到media下的uploads子目录，也可以留空直接存在media根目录
image_sale = models.ImageField(blank=True, upload_to='uploads/')

修改后执行python manage.py makemigrations和python manage.py migrate更新表结构。

3. 修复模板index.html的逻辑：
   你的ListView配置的context_object_name是goods，是查询返回的列表，需要先遍历，同时判断条件和路径引用都要调整，不用手动拼接MEDIA_URL，ImageField实例自带url属性：

{% for good in goods %}
    {% if good.image_sale %}
        <img src="{{ good.image_sale.url }}">
    {% endif %}
{% endfor %}

4. 确认模板上下文配置：
   打开settings.py找到TEMPLATES配置项，确认上下文处理器中包含media处理器，保证模板可以正常读取MEDIA_URL变量：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                # 保留原有其他处理器
                'django.template.context_processors.media',
            ],
        },
    },
]

额外提示 #

你写在IndexView里的description、price、image方法属于模型层的属性方法，应该移到Goods模型类中，写在视图类里模板无法直接调用。

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