Django怎么优雅发送邮件_Python配置SMTP后端实现异步通知-Python教程-PHP中文网

根本原因是django默认同步连接smtp且本地无邮件服务或端口未开放；需确认email_backend为smtp后端、使用应用专用密码、适配465/587端口，并用线程实现异步发送。

django怎么优雅发送邮件_python配置smtp后端实现异步通知

SMTP配置后邮件发不出去，`send_mail` 卡住或报 `ConnectionRefusedError`

根本原因通常是 Django 默认用同步方式连 SMTP 服务器，而本地开发环境没装邮件服务，或生产环境防火墙/端口没放开。别急着换库，先确认连接通不通：

python -c "import smtplib; s = smtplib.SMTP('smtp.gmail.com', 587); s.starttls(); print('OK')" —— 手动测通路，绕过 Django
Django 的 EMAIL_BACKEND 必须设为 'django.core.mail.backends.smtp.EmailBackend'，不是默认的 console 后端
Gmail/Outlook 等需要开启「应用专用密码」或 OAuth2，普通账号密码大概率被拒，错误信息通常是 SMTPAuthenticationError
阿里云、腾讯云 ECS 默认封 25 端口，得改用 465（SSL）或 587（TLS），对应配置 EMAIL_USE_SSL 或 EMAIL_USE_TLS，二者不能同时为 True

想发邮件不阻塞视图响应，但又不想引入 Celery

直接用线程最轻量，Django 自身不带异步邮件发送能力，send_mail 是纯同步调用。硬上 async/await 没用 —— SMTP 库大多不支持 asyncio。

用 threading.Thread 包一层最稳妥：

from threading import Thread
def send_async_mail(*args, **kwargs):
    Thread(target=send_mail, args=args, kwargs=kwargs).start()

注意：线程里不能依赖 request 对象或未序列化的上下文（比如 model 实例），得提前取好 str 或 dict 数据传进去
别用 concurrent.futures.ThreadPoolExecutor 做简单通知——线程池适合复用，单次发信反而增加调度开销
如果并发量真高（比如每秒几十封），线程还是不如 Celery + Redis，但那是另一个量级的问题了

`send_mail` 和 `EmailMessage` 该选哪个

send_mail 只能发纯文本，附件、HTML 内容、多收件人抄送都得换 EmailMessage。它不是“高级版”，而是“必须用”的底层接口。

Claw Code Suite (Python-Only Edition)

仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...

下载

send_mail 本质就是封装了 EmailMessage 的简单调用，参数少，适合密码重置这类单文本通知

要嵌入图片、加附件、用模板渲染 HTML，必须用 EmailMessage：

msg = EmailMessage(
    subject='订单完成',
    body='<h1>感谢下单</h1>', 
    from_email='noreply@example.com',
    to=['user@example.com']
)
msg.content_subtype = 'html'
msg.send()

EmailMessage 的 to、cc、bcc 都是 list，别传字符串，否则发信失败但无提示
模板里用 {% autoescape off %} 渲染 HTML 邮件时，确保内容可信，否则 XSS 风险直接进收件箱

测试环境邮件全发到控制台，但上线后收不到

因为 EMAIL_BACKEND 在不同环境配错了。Django 不会自动切换，靠你手动区分。

开发时设 EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'，邮件打 stdout，不发真实网络请求
生产环境必须显式覆盖为 SMTP 后端，并且 EMAIL_HOST、EMAIL_PORT、EMAIL_HOST_USER、EMAIL_HOST_PASSWORD 全部非空
别把密码写死在 settings.py 里，用环境变量：os.getenv('EMAIL_HOST_PASSWORD', '')，否则部署时容易漏改
有些 SMTP 服务商（如 Mailgun）要求发信域名在白名单里，Django 的 DEFAULT_FROM_EMAIL 必须和验证过的域名一致，否则静默丢弃