使用Python smtplib库发送Gmail邮件报SMTPServerDisconnected错误如何解决
问题根源与解决方案
核心报错原因
你遇到的连接断开问题是端口和SMTP类不匹配导致的:Gmail的465端口属于隐式TLS(SSL)端口,不能使用普通的smtplib.SMTP类初始化,必须改用smtplib.SMTP_SSL类,普通SMTP类仅适配587这类需要显式调用starttls()开启加密的端口。
其他需要修正的问题
- 你的邮件内容字符串没有做插值替换,实际发出去的内容会保留
{subject}这类占位符,不会替换为实际值 - 587端口的认证失败大概率是使用了Gmail账号的普通登录密码,现在Gmail已经禁止第三方客户端使用普通密码登录SMTP服务,必须开启两步验证后生成专属应用密码用于认证
- POP3、IMAP是邮件接收协议,和SMTP发信权限无关,你开启的这两个权限对发信没有影响
修正后的可运行代码(465端口版本)
import smtplib from email.utils import formataddr subject = 'This is a test subject' body = 'This is a test body' # 配置完整邮件头+格式化内容 message = (f"From: {formataddr(('发件人名称', 'XXXX@gmail.com'))}\r\n" f"To: {formataddr(('收件人名称', 'YYYY@gmail.com'))}\r\n" f"Subject: {subject}\r\n\r\n" f"{body}") # 465端口用SMTP_SSL初始化,无需额外调用starttls server = smtplib.SMTP_SSL(host='smtp.gmail.com', port=465) try: server.ehlo() # 登录密码需填写Gmail应用密码,不是账号普通登录密码 server.login('XXXX@gmail.com', '你的16位Gmail应用密码') server.sendmail('XXXX@gmail.com', 'YYYY.smithson@gmail.com', message.encode('utf-8')) except Exception as e: print(e) finally: server.quit()
额外配置说明
- 应用密码生成路径:先给发件Gmail账号开启两步验证,之后进入Google账号设置,搜索「应用密码」,选择
邮件类应用、对应设备后生成16位无空格的应用密码,替换代码中的密码字段即可 - 如果你要使用587端口,仅需修改初始化代码为
server = smtplib.SMTP(host='smtp.gmail.com', port=587),并在server.ehlo()后新增一行server.starttls()即可,其他逻辑和465端口完全一致
内容的提问来源于stack exchange,提问作者mafxs
相关产品推荐
相关产品推荐

