aiosmtplib卡主线程的根本原因是未纳入async生命周期，必须全程异步调用、由asyncio.run()管理事件循环，且参数需完整（hostname/port/username/password/use_tls）、message须为EmailMessage实例。
为什么 aiosmtplib 发邮件还是卡住主线程？
根本原因不是库没用对，而是你没把它真正放进 async 生命周期里。常见错误是：在同步函数里直接 await aiosmtplib.send()，或者用 loop.run_until_complete() 手动驱动——这会阻塞当前线程，失去异步意义。
必须确保调用链全程异步：从入口函数（async def main()）开始，所有涉及网络 I/O 的环节都用 await，且事件循环由 asyncio.run() 统一管理。
- 别在
if __name__ == "__main__":下直接写await，必须包进async函数再传给asyncio.run() - 避免混用
threading或concurrent.futures包裹aiosmtplib——它本身已为异步优化，额外线程反而引入调度开销和上下文混乱 - SMTP 服务器响应慢（比如某些企业邮箱限制发信频率）时，
aiosmtplib仍会 await 超时，这不是 bug，是协议层行为；需靠重试逻辑或队列缓冲来应对，而非改用同步方式
aiosmtplib.send() 必须传哪些参数才不报 TypeError？
最常踩的坑是漏传 hostname 和 port，或把 username/password 错当成位置参数。该函数签名严格，缺一不可（除非用默认端口且服务支持隐式 TLS）。
典型正确调用：
立即学习“Python免费学习笔记（深入）”；
await aiosmtplib.send(
message,
hostname="smtp.gmail.com",
port=587,
username="your@gmail.com",
password="app_password_here",
use_tls=True
)
-
message必须是email.message.EmailMessage实例，不能是字符串或字典；用email.message.EmailMessage()构建，设.set_content()或手动加MIME头 -
use_tls=True表示 STARTTLS（明文连接后升级），use_ssl=True表示 SMTPS（直连加密端口 465）；二者互斥，选错会导致连接被拒或超时 - Gmail 等服务现在强制要求应用专用密码，填账号密码会失败并抛
aiosmtplib.errors.SMTPAuthenticationError
并发发多封邮件时，aiosmtplib 连接池怎么管？
它不自动复用连接——每次 send() 都新建 TCP 连接 + TLS 握手 + 认证，高频调用下开销明显。想压测或群发，得自己封装连接复用逻辑。
推荐做法：用 aiosmtplib.SMTP 实例维持长连接，显式 connect() → login() → 多次 send_message() → quit()：
smtp = aiosmtplib.SMTP(hostname="smtp.gmail.com", port=587, use_tls=True)
await smtp.connect()
await smtp.login("user", "pass")
for msg in messages:
await smtp.send_message(msg)
await smtp.quit()
- 注意异常处理：若某次
send_message()失败（如收件人格式错），连接可能仍有效，可继续发下一封；但遇到认证失败或服务器断连，需重建实例 - 不要跨协程共享同一
SMTP实例，除非加锁；并发场景建议每个任务独占连接，或用asyncio.Semaphore控制并发连接数（比如限制最多 3 个活跃 SMTP 会话） - 某些邮件服务商（如 Outlook）对单连接发送数量有限制，超限会断连，此时需捕获
aiosmtplib.errors.SMTPRecipientsRefused后主动重连
本地开发用 aiosmtplib 测试总连不上，是不是配置错了？
大概率是本地没配好 SMTP 服务或绕过了真实发信路径。开发阶段不该直连生产邮箱（易触发风控、配额耗尽），也不该依赖本机 sendmail（它非异步，且 aiosmtplib 不兼容）。
- 用
MailHog或MailCatcher启一个本地 SMTP 接收服务（监听127.0.0.1:1025），然后aiosmtplib.send(..., hostname="127.0.0.1", port=1025, use_tls=False)—— 它不校验认证，纯收信，适合验证流程 - 别用
localhost当hostname：某些系统解析慢或失败，明确写127.0.0.1 - 防火墙或 Docker 网络隔离可能导致连接被拒，错误通常是
OSError: [Errno 111] Connection refused，先telnet 127.0.0.1 1025确认端口通不通
异步发邮件真正的复杂点不在语法，而在连接生命周期管理、错误恢复策略和与业务逻辑的耦合方式。比如发验证码这种低延迟敏感场景，得考虑失败降级到短信通道；而批量通知则要控制速率、记录投递状态、避免被当垃圾邮件。这些没法靠换一个库解决，得在调用层设计清楚。
