自定义Django Allauth模板：注册验证HTML邮件无法正常生效问题求助

咱们来搞定Django Allauth HTML验证邮件不生效的问题，这是个常见坑，几个简单调整就能解决：

你现在的HTML模板继承的是account/email/base_message.txt——这是纯文本的基础模板，完全不对！HTML模板应该继承Allauth提供的HTML基础模板account/email/base_message.html，或者自己创建一个HTML版的基础模板。

修改模板开头：

{% extends "account/email/base_message.html" %}
{% load account %}
{% load i18n %}

如果项目里没有base_message.html，可以在templates/account/email/下创建一个极简版本：

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
</head>
<body>
    {% block content %}{% endblock %}
</body>
</html>

你把整个HTML结构塞进了{% blocktrans %}标签里，这会让翻译标签把HTML代码当成纯文本处理，还会引发变量解析错误。应该把静态HTML部分放在翻译标签外，只把需要翻译的文本内容用{% blocktrans %}包裹。

重新整理后的模板示例：

{% extends "account/email/base_message.html" %}
{% load account %}
{% load i18n %}

{% block content %}
{% autoescape off %}
{% user_display user as user_display %}
<!doctype html>
<html>
<head>
    <meta charset='utf-8'>
    <meta name='viewport' content='width=device-width, initial-scale=1'>
    <link href='https://stackpath.bootstrapcdn.com/bootstrap/5.0.0-alpha1/css/bootstrap.min.css' rel='stylesheet'>
    <script type='text/javascript' src='https://cdn.jsdelivr.net/npm/popper.js@1.16.0/dist/umd/popper.min.js'></script>
    <script type='text/javascript' src='https://stackpath.bootstrapcdn.com/bootstrap/5.0.0-alpha1/js/bootstrap.min.js'></script>
</head>
<body>
    <div style="display: none; font-size: 1px; color: #fefefe; line-height: 1px; font-family: 'Lato', Helvetica, Arial, sans-serif; max-height: 0px; max-width: 0px; opacity: 0; overflow: hidden;">
        {% trans "We're thrilled to have you here! Get ready to dive into your new account." %}
    </div>
    <table border="0" cellpadding="0" cellspacing="0" width="100%">
        <table border="0" cellpadding="0" cellspacing="0" width="100%" style="max-width: 600px;">
            <tr>
                <td bgcolor="#ffffff" align="left" style="padding: 20px 30px 40px 30px; color: #666666; font-family: 'Lato', Helvetica, Arial, sans-serif; font-size: 18px; font-weight: 400; line-height: 25px;">
                    <p style="margin: 0;">
                        {% blocktrans with site_domain=current_site.domain %}We're excited to have you get started on {{ site_domain }}. First, you need to confirm your account. Just press the button below.{% endblocktrans %}
                    </p>
                </td>
            </tr>
            <tr>
                <td bgcolor="#ffffff" align="left">
                    <table width="100%" border="0" cellspacing="0" cellpadding="0">
                        <tr>
                            <td bgcolor="#ffffff" align="center" style="padding: 20px 30px 60px 30px;">
                                <table border="0" cellspacing="0" cellpadding="0">
                                    <tr>
                                        <td align="center" style="border-radius: 3px;" bgcolor="#FFA73B">
                                            <a href="{{ activate_url }}" target="_blank" style="font-size: 20px; font-family: Helvetica, Arial, sans-serif; color: #ffffff; text-decoration: none; padding: 15px 25px; border-radius: 2px; border: 1px solid #FFA73B; display: inline-block;">
                                                {% trans "Confirm Account" %}
                                            </a>
                                        </td>
                                    </tr>
                                </table>
                            </td>
                        </tr>
                    </table>
                </td>
            </tr>
            <tr>
                <td bgcolor="#ffffff" align="left" style="padding: 0px 30px 0px 30px; color: #666666; font-family: 'Lato', Helvetica, Arial, sans-serif; font-size: 18px; font-weight: 400; line-height: 25px;">
                    <p style="margin: 0;">
                        {% trans "If that doesn't work, copy and paste the following link in your browser:" %}
                    </p>
                    <p style="margin: 10px 0;">{{ activate_url }}</p>
                </td>
            </tr>
        </table>
</body>
</html>
{% endautoescape %}
{% endblock %}

注意{{ activate_url }}要单独使用，不要嵌套在blocktrans里，避免变量解析失败。

确保Django项目的邮件后端支持发送多部分（text/html）邮件，默认的django.core.mail.backends.smtp.EmailBackend是支持的。同时检查Allauth的设置，不要强制使用纯文本邮件：

# settings.py
ACCOUNT_EMAIL_VERIFICATION = "mandatory"  # 保持默认或设置为mandatory/optional
ACCOUNT_EMAIL_SUBJECT_PREFIX = '[你的站点名称] '

HTML模板必须放在以下路径，且文件名完全匹配：
你的项目根目录/templates/account/email/email_confirmation_message.html
注意Linux服务器上路径大小写敏感，别拼错account、email这些目录名。

开发环境下重启Django服务器，生产环境清除模板缓存或重新部署，避免旧模板内容被缓存。

调整完成后，Allauth会自动发送多部分邮件——支持HTML的邮箱客户端会显示你的自定义HTML模板，不支持的则回退到文本版。

内容的提问来源于stack exchange，提问作者adel bouakaz