Django未上传用户头像时报错user_image无关联文件该如何解决？

报错原因 #

你触发报错的核心原因是：Django的FileField/ImageField类型字段，当未上传任何文件时，直接调用.url属性会主动抛出ValueError，你原来的模板判断逻辑先访问了values.user_image.url，自然会在无头像场景触发报错。

修复方案（两种可选，推荐第一种） #

方案1：修改模板判断逻辑（无需改动后端代码，最快生效） #

把原来的判断条件从判断url改为直接判断user_image字段本身是否有值，Django的文件字段在布尔上下文中会自动识别是否关联了文件，不会触发报错。
修改后的dashboard.html代码如下：

{% load static %}
<!-- 只需要修改if判断条件即可 -->
{% if values.user_image %}
   <a class="image" href="{% url 'setting' %}"><img src="{{ values.user_image.url }}" alt=""></a>
{% else %}
   <a class="image" href="{% url 'setting' %}"><img src="{% static 'img/user.png' %}" alt=""></a>
{% endif %}

注意要确保模板顶部已经加载了static标签，也就是开头有{% load static %}，否则static指令会报错。

方案2：在模型层设置默认头像（后续无需写判断逻辑） #

如果你想要简化模板代码，可以直接在User模型的user_image字段定义处添加默认值配置，示例如下：

from django.db import models

class User(models.Model):
    # 其他字段省略
    user_image = models.ImageField(upload_to='user_avatars/', default='img/user.png', blank=True)

注意default填写的路径要和你静态文件夹下的默认头像路径对应，配置完成后模板可以直接写一行代码即可，无需if判断：

<a class="image" href="{% url 'setting' %}"><img src="{{ values.user_image.url }}" alt=""></a>

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