Django中'Image'属性无关联文件错误及图片不显示问题求助

错误含义 #

这个错误的核心是：你尝试访问BookDetails模型中Image字段的.url属性，但该字段并没有关联任何实际上传的图片文件。可能的场景包括：数据库里这条记录的Image字段为空，或者图片上传未成功却强行调用了.url。

问题排查与解决步骤 #

1. 视图层：避免强行获取未上传的图片 #

你的视图代码中使用req.FILE['image']，如果用户提交表单时没有选择图片，这会直接抛出KeyError，而且即使模型允许Image字段为空，强行赋值不存在的文件也会导致后续问题。修改为get方法获取，允许空值：

def bookdata(req):
    if req.method == "POST":
        b_name = req.POST.get('book name')
        a_name = req.POST.get('author name')
        p_year = req.POST.get('published year')
        price = req.POST.get('price')
        # 用get方法，未上传图片时返回None
        image = req.FILE.get('image')
        obj = BookDetails(Name=b_name, A_Name=a_name, P_Year=p_year, Price=price, Image=image)
        obj.save()
        return redirect(add_books)

2. 模板层：判断图片存在后再渲染 #

模板中直接调用{{ i.Image.url }}会在Image为空时触发ValueError，必须先判断字段是否有值：

<td>
    {% if i.Image %}
        <img src="{{ i.Image.url }}">
    {% else %}
        <span>暂无图片</span>
    {% endif %}
</td>

3. 配置媒体文件访问（图片无法显示的关键） #

你改成<img src="{{ i.Image }}">后无错误但不显示图片，是因为Django需要正确配置媒体文件的存储路径和访问URL，才能让浏览器加载到上传的图片：

第一步：修改settings.py

添加以下配置：

import os

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# 媒体文件存储根目录
MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
# 媒体文件访问URL前缀
MEDIA_URL = '/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)

这样配置后，i.Image.url会生成类似/media/book images/xxx.jpg的完整可访问路径，浏览器就能正确加载图片了。

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