Django Admin页面图片无法显示问题求助

以下是针对问题的关键排查点和解决方法：

1. 修正ImageField的upload_to路径 #

你的models.py中upload_to参数设置有误。Django的upload_to是相对于MEDIA_ROOT的子路径，如果你的MEDIA_ROOT已经配置为PROJECTNAME/media，那么upload_to='media/profile_image/'会导致图片被存储到PROJECTNAME/media/media/profile_image/，和实际期望的路径不符。

修改models.py：

class User(AbstractBaseUser, PermissionsMixin):
    image = models.ImageField(
        upload_to='profile_image/',  # 去掉前面的media/
        null=True
    )

2. 配置开发环境的媒体文件路由 #

开发阶段Django不会自动处理媒体文件的静态服务，需要在项目的urls.py中添加媒体文件的URL映射：

先导入必要模块：

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

再在urlpatterns末尾添加：

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

同时确保settings.py中正确配置MEDIA参数：

MEDIA_ROOT = BASE_DIR / 'media'
MEDIA_URL = '/media/'

3. 确保导入format_html #

你的admin.py中使用了format_html但未显示导入，这会导致代码报错无法生成图片标签。在admin.py顶部添加：

from django.utils.html import format_html

4. 优化list_display配置 #

list_display中同时包含image和image_tag会重复显示，建议只保留image_tag用于预览，同时增加空值判断避免报错，设置列标题提升可读性：

class UserAdmin(BaseUserAdmin):
    # ... 其他代码 ...
    def image_tag(self, obj):
        if obj.image:
            return format_html(
                f'''<a href="{obj.image.url}" target="_blank">
                      <img 
                        src="{obj.image.url}" alt="{obj.image}" 
                        width="50" height="50"
                        style="object-fit: cover;"
                      />
                    </a>''')
        return ""

    image_tag.short_description = "头像预览"
    list_display = ('uid','get_full_name', 'email', 'nickname', 'introduce', 'birth','is_active', 'is_superuser', 'date_joined', 'image_tag')

5. 验证文件路径与URL匹配 #

检查实际存储的图片路径是否为PROJECTNAME/media/profile_image/[图片文件名]，然后在浏览器中直接访问http://localhost:8000/media/profile_image/[图片文件名]。如果无法访问，说明路由或路径配置有问题；如果能访问，刷新Admin页面即可查看图片。

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