Django-avatar模板标签{% avatar user %}报ValueError问题求助

问题背景 #

在基于Django 4.2.4、Python 3.11.5的项目中，使用django-avatar与allauth组件时，访问/dashboard/页面触发ValueError: not enough values to unpack (expected 2, got 1)，错误定位在模板的{% avatar user %}标签处。核心原因是django-avatar的默认头像提供者尝试拆分不含@的邮箱地址（allauth允许用户使用无@的邮箱/纯用户名注册），导致拆分失败。

相关模板代码：

{% extends 'base.html' %}
{% load account %} {% load avatar_tags %}

{% block content %}

<div style="border: 2px solid #ffffff; text-align:center">
    <h1>Dashboard</h1>
    <div>
        {% avatar user %}
        <a href="{% url 'avatar_change' %}">Change your avatar</a>
    </div>
    <div>
        <p>Welcome back, {% user_display user %}</p>
    </div>
</div>

{% endblock content %}

修复方案 #

方案1：自定义安全的头像提供者（推荐） #

避免直接修改第三方库代码，通过自定义Provider处理无@的邮箱/用户名：

1. 在项目中创建自定义Provider文件（如your_app/providers.py）：

from avatar.providers import EmailDefaultAvatarProvider
import hashlib

class SafeEmailAvatarProvider(EmailDefaultAvatarProvider):
    def get_default_avatar_url(self, user):
        # 优先取邮箱，无邮箱则用用户名
        identifier = user.email or user.username
        if '@' not in identifier:
            # 直接对标识符生成Gravatar链接，或返回自定义默认头像URL
            hash_str = hashlib.md5(identifier.lower().encode('utf-8')).hexdigest()
            return f"https://www.gravatar.com/avatar/{hash_str}?d=mp"
        # 有@的邮箱使用原逻辑处理
        return super().get_default_avatar_url(user)

2. 在settings.py中替换默认Provider：

AVATAR_PROVIDERS = [
    'your_app.providers.SafeEmailAvatarProvider',
    # 保留其他需要的Provider，比如：
    # 'avatar.providers.GravatarAvatarProvider',
]

方案2：修改django-avatar的源码（临时应急） #

如果只是临时修复，可直接修改avatar/providers.py中拆分邮箱的代码：
找到以下代码：

local, domain = email.split('@')

修改为：

if '@' in email:
    # 只拆分一次，避免多个@的情况
    local, domain = email.split('@', 1)
else:
    local = email
    domain = 'local'  # 或设置任意默认域名

注意：这种方法在django-avatar升级后会失效，不推荐长期使用。

方案3：强制用户邮箱格式（业务限制） #

如果业务允许，可在allauth注册流程中强制用户填写含@的有效邮箱，或在用户创建时自动为无@的邮箱补充默认域名（如username@yourdomain.com），但此方法会限制用户注册方式，灵活性较低。

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