Django无法从数据库拉取数据及Subject模型ImageField模板渲染错误排查

已确认的问题点 #

• 模板字段名调用错误：Subject模型定义的字段为name、thumbnail，模板中错误使用subject.subject_name、subject.subject_thumbnail，额外添加的subject_前缀不存在，无法匹配模型字段读取内容。
• 图片字段引用方式错误：Django的ImageField类型字段需要调用.url属性才能生成合法的资源访问路径，直接调用字段本身无法得到可访问的图片地址。
• 潜在路径解析隐患：thumbnail字段的upload_to参数值包含空格'subject thumbnail'，部分服务器环境下会引发路径解析异常。
• 可能缺失媒体资源配置：未配置媒体文件的存储路径和访问路由时，即使字段引用正确也无法正常加载图片。

修复步骤 #

1. 修正模板代码，替换原有模板段为以下内容：

<div>
      <ul>
      {% for subject in subject_list %}
      <li> <a href=""> <img src="{{ subject.thumbnail.url }}" alt="{{ subject.name }}"> {{ subject.name }} </a> </li>
      {% endfor %}
    </ul>
    </div>

2. （可选）优化模型字段的存储路径，避免空格引发的异常：
   修改models.py中thumbnail字段定义为：
   thumbnail = models.ImageField(upload_to='subject_thumbnail', blank = False)
   修改后执行python manage.py makemigrations、python manage.py migrate命令同步数据库变更。
3. 配置项目媒体资源服务：
   在settings.py中添加媒体存储配置：

# 媒体文件本地存储根目录
MEDIA_ROOT = BASE_DIR / 'media'
# 媒体文件访问路由前缀
MEDIA_URL = '/media/'

在项目根urls.py中添加开发环境下的媒体路由：

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

urlpatterns = [
    # 原有项目路由保持不变
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

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