Django添加ImageField字段遇问题：后台不显示且模型迁移报错

一、先处理makemigrations的报错 #

你看到的报错和新增的featured_image字段无关，核心问题是数据库中已有Article记录的topic字段为NULL，但当前模型中topic未设置null=True，Django需要为这些旧记录补上topic的值才能完成迁移。

解决方法二选一：

• 若允许文章不关联话题：修改Article模型的topic字段，添加null=True, blank=True：

  topic = models.ForeignKey(Topic, on_delete=models.CASCADE, null=True, blank=True)
  

  之后重新执行python manage.py makemigrations和python manage.py migrate。
• 若文章必须关联话题：执行makemigrations时选择选项1，输入一个已存在的Topic对象的主键ID（比如后台已创建的某个话题的id，通常是1），Django会自动把所有旧文章的topic设为这个默认值，完成迁移后再执行python manage.py migrate。

二、让featured_image字段在后台显示并正常工作 #

1. 补充MEDIA相关配置 #

ImageField上传的文件需要MEDIA目录存储，后台也需要访问MEDIA的路由，在settings.py中添加：

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

2. 配置MEDIA路由 #

在项目根目录的urls.py中添加：

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

urlpatterns = [
    path('admin/', admin.site.urls),
    # 你的其他路由
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

3. 确保默认图片路径正确 #

把default.jpg放到项目根目录的media文件夹下（没有就新建一个），模型中的default="default.jpg"就会生效。

4. 检查Admin注册 #

确保admin.py中正确注册了Article模型，并包含featured_image字段：

from django.contrib import admin
from .models import Article, Topic

class ArticleAdmin(admin.ModelAdmin):
    list_display = ('title', 'topic', 'created')
    fields = ('topic', 'title', 'featured_image', 'content', 'created', 'updated')
    readonly_fields = ('created', 'updated')

admin.site.register(Topic)
admin.site.register(Article, ArticleAdmin)

三、最终操作流程 #

1. 按上述修改模型和配置文件
2. 执行python manage.py makemigrations
3. 执行python manage.py migrate
4. 重启Django服务器，进入后台即可看到featured_image字段，能正常上传图片，默认图也会显示。

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