SMTP客户端邮件代码无法运行，请求排查方向指引

别担心，这种“之前运行正常突然失效”的问题大多源于容易被忽略的细节，我给你梳理几个优先级较高的排查方向：

• 核对SMTP核心配置

  • 先确认服务器地址、端口是否正确：比如常见的smtp.gmail.com端口是587（TLS），smtp.qq.com有465（SSL）和587（TLS）两种，有没有不小心改了端口或地址？
  • 验证认证信息：是不是邮箱密码过期、修改过？如果开启了两步验证，必须用应用专用密码而非原密码登录，这是很多人踩坑的点。
  • 加密协议匹配：代码里用的是STARTTLS还是SSL？有些服务商最近禁用了老旧的TLS 1.0/1.1协议，看看是不是加密配置和服务器要求不匹配。

• 排查网络与安全限制

  • 换个网络测试：比如从公司内网换成手机热点，很多企业防火墙会拦截SMTP出站请求，排除网络环境的问题。
  • 检查本地安全工具：杀毒软件、防火墙有没有更新规则？有些工具会突然拦截SMTP端口（587/465），暂时关闭后测试是否恢复正常。

• 回溯代码的细微改动

  • 对比版本历史：如果用了Git等版本控制工具，直接对比最近的代码提交，重点看这些地方：收件人/发件人地址是否有拼写错误（比如多了空格、少了@）、邮件编码是否变更（比如从UTF-8改成了GBK导致服务器拒绝）、附件路径是否失效。
  • 补充错误日志：在代码里添加详细的异常捕获，打印SMTP服务器返回的错误码和具体信息——服务器通常会明确告诉你问题所在，比如535 5.7.8 认证失败、550 5.7.1 收件人不存在，这些信息是定位问题的关键。

• 检查邮件格式合规性

  • 验证邮件格式：有没有用不符合RFC标准的换行符？比如用\n代替了\r\n，部分严格的SMTP服务器会拒绝这种不规范的邮件。
  • 测试简化版邮件：暂时去掉附件、复杂的HTML内容，只发送纯文本测试邮件，排除内容里的特殊字符或格式触发了反垃圾规则。

• 确认依赖与环境变化

  • 检查依赖库版本：有没有更新过SMTP相关的库？比如Python的smtplib、Java的JavaMail，新版本可能调整了默认行为（比如不再默认信任自签证书）。
  • 核实运行环境：是不是操作系统、语言版本升级了？比如Python 3.10+对SSL证书的验证更严格，之前能跑的代码可能因为证书问题失败。

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