You need to enable JavaScript to run this app. 使用Python smtplib库发送Gmail邮件报SMTPServerDisconnected错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 20:06:05