如何在Django模板中跳过FileNotFoundError错误？

架构老林

2026-8-14

解决Django模板中FileNotFoundError的方案

你的问题核心是：obj.profile_pictures字段在数据库中有记录，但对应的实际文件已被删除或路径错误，仅判断字段是否存在无法覆盖这种情况，调用.url时就会触发FileNotFoundError。以下是几种可行的解决办法：

方案1：在模型中添加文件验证方法

在对应的模型里新增一个方法，用来检查文件是否真实存在：

import os
from django.conf import settings
from django.db import models

class YourModel(models.Model):
    profile_pictures = models.ImageField(upload_to='profiles/', blank=True, null=True)

    def has_valid_profile_picture(self):
        if self.profile_pictures:
            # 拼接完整本地路径并检查文件是否存在
            file_path = os.path.join(settings.MEDIA_ROOT, self.profile_pictures.name)
            return os.path.exists(file_path)
        return False

之后在模板里改用这个方法做判断：

{% if obj.has_valid_profile_picture %}
<img src="{{ obj.profile_pictures.url }}" >
{% else %}
<img src="{% static 'assets/img/alt_img.jpg' %}" >
{% endif %}

方案2：自定义模板过滤器

创建一个可复用的模板过滤器来检查文件状态：

在你的App目录下新建templatetags文件夹，里面创建file_check_filters.py文件：

from django import template
from django.conf import settings
from django.core.files.storage import default_storage

register = template.Library()

@register.filter
def file_exists(file_field):
    if not file_field:
        return False
    # 兼容本地存储和自定义存储后端（如S3）
    return default_storage.exists(file_field.name)

在模板顶部加载这个过滤器：

{% load file_check_filters %}

修改模板中的判断逻辑：

{% if obj.profile_pictures|file_exists %}
<img src="{{ obj.profile_pictures.url }}" >
{% else %}
<img src="{% static 'assets/img/alt_img.jpg' %}" >
{% endif %}