Django中无法从数据库显示图片问题求助

问题现象 #

模板中使用{{beat.image.url}}无法加载数据库中存储的图片，相关代码配置如下：

index.html

<img src="{{beat.image.url}}" class="card-img-top" alt="{{beat.name}}">

settings.py

STATIC_URL = '/static/'

MEDIA_URL = '/media/'
MEDIA_ROOT = os.path.join(BASE_DIR, 'beat/media')

models.py

image = models.ImageField(upload_to='images', blank=True)

urls.py

urlpatterns = [
    path('', views.index, name='index'),
    path('test', views.test, name='test'),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

排查与解决步骤 #

• 验证MEDIA路径配置
  确认MEDIA_ROOT指向的目录存在且有读写权限。os.path.join(BASE_DIR, 'beat/media')意味着media文件夹在beat应用目录下，手动检查该目录是否存在，若不存在则创建，同时确保服务器进程对该目录有写入权限。

• 检查Pillow依赖
  ImageField依赖Pillow库，执行pip install pillow安装依赖，安装完成后重启开发服务器。

• 确认图片已实际上传
  检查MEDIA_ROOT/images/目录下是否存在对应图片文件。若数据库中beat对象的image字段有值，但实际文件不存在，需重新上传图片。

• 模板中添加空值判断
  由于blank=True允许image字段为空，若beat对象的image为None，{{beat.image.url}}会导致无效路径。修改模板代码：

  {% if beat.image %}
    <img src="{{beat.image.url}}" class="card-img-top" alt="{{beat.name}}">
  {% endif %}
  

• 确认urls配置位置
  + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)必须添加在项目根目录的urls.py中，而非应用的urls.py文件。若之前配置在应用urls中，移至根urls.py后重启服务器。

• 重启开发服务器
  修改settings或urls配置后，务必重启Django开发服务器，确保新配置生效。

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