Django拍卖系统报错：'image'属性未关联文件

问题描述 #

开发Django拍卖系统时，访问商品列表页面触发错误：Exception Value: The 'image' attribute has no file associated with it。移除模板中的图片引用代码后，页面可正常加载但无法显示商品图片。

相关代码 #

auction.html #

{% extends "base.html" %}
{% block content %}
{% load static %}
   <div class="page-header">
        <h1>OPEN AUCTIONS</h1>
    </div>
        <div class="container">
        <div class="row">
                    {% for item in auction %}
            <div class="col-sm-4">
                <div class="card border-secondary" style="width: 25rem;">
                <div class="card-header">
                    Auction {{item.id}}
                </div>
                  <img src="{{ item.image.url }}" class="card-img-top" width="250" height="180">
                  <div class="card-body">
                    <h3 class="card-title" style="text-align:center"  >{{ item.object }}</h3>
                    <p class="card-text">{{item.description}}<br> Price: ${{ item.open_price}}<br>
                    End: {{ item.close_date }}</p>
                      <form method="POST">
                    {% csrf_token %}
                    <input type="number" name='auct_id' value={{item.id}}  readonly>
                    <button type="submit" class="btn btn-primary btn-sm">Go</button>
                    </form>
                  </div>
                </div>
            </div>
        {% endfor %}
        </div>
        </div>
        {% endblock %}

views.py #

@login_required(login_url="login")
def auction(request):
    if request.user.is_superuser:
        messages.error(
            request, "super user can access to admin/ and new_auction page only"
        )
        return redirect("new_auction")
    auction = Auction.objects.filter(active=True)
    for data in auction:
        check = check_data(data.close_date)
        if check is False:
            data.active = False
            data.save()
            check_winner(
                request, data.id
            )
    check_prof = check_profile(
        request
    )  
    if check_prof is True:
        return redirect("profile")
    auctions_open = Auction.objects.filter(active=True)
    if request.method == "POST":
        form = request.POST
        auct_ids = form["auct_id"]
        auct_id = int(auct_ids)
        request.session["selected_id"] = auct_id
        return redirect("betting")
    else:
        return render(request, "auction/auction.html", {"auction": auctions_open})

models.py #

from django.db import models
from django.contrib.auth.models import User
from datetime import datetime

# Create your models here.


class Auction(models.Model):
    object = models.CharField(max_length=50)
    description = models.CharField(max_length=256, default="")
    image = models.ImageField(upload_to="media/", null=True, blank=True)
    open_date = models.DateTimeField(auto_now_add=True)
    close_date = models.DateTimeField()
    total_bet = models.IntegerField(default=0)
    open_price = models.FloatField(
        default=0,
    )
    close_price = models.FloatField(default=0)
    winner = models.CharField(max_length=256, default="")
    active = models.BooleanField(default=True)
    json_details_file = models.TextField(default="")
    tx = models.CharField(max_length=256, default="")

    def __str__(self):
        return self.object

settings.py #

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

解决方案 #

1. 模板中添加图片存在性判断 #

直接访问未关联文件的image.url会触发错误，需在模板中先判断图片是否存在再渲染：

{% if item.image %}
  <img src="{{ item.image.url }}" class="card-img-top" width="250" height="180">
{% else %}
  <!-- 可选：添加默认占位图，需提前在static目录放置对应图片 -->
  <img src="{% static 'images/default-auction-item.jpg' %}" class="card-img-top" width="250" height="180">
{% endif %}

2. 优化模型图片存储路径 #

当前upload_to="media/"会导致文件存储在BASE_DIR/media/media/，路径冗余，建议修改为更清晰的目录：

# models.py
image = models.ImageField(upload_to="auction_images/", null=True, blank=True)

修改后图片会存储在BASE_DIR/media/auction_images/，更易维护。

3. 配置开发环境媒体文件访问路由 #

开发阶段Django不会自动处理媒体文件的HTTP访问，需在项目根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)

这一步确保浏览器能正确加载媒体文件。

4. 检查已有商品数据 #

部分商品可能因创建时未上传图片，或在添加image字段前创建，导致image字段为空。可通过Django Admin检查这些商品，补充图片或确认无需图片的商品状态。

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