本文旨在解决使用python `smtplib`库发送邮件时遇到的`[errno 60] operation timed out`错误，尤其针对gmail账户。核心问题源于gmail的安全策略，阻止了第三方应用直接通过传统smtp方式连接。教程将详细介绍如何通过生成gmail应用密码（推荐）或启用“允许安全性较低的应用访问”功能来解决此问题，并提供优化的python代码示例及相关注意事项，确保邮件发送成功。
理解smtplib邮件发送超时错误
在使用Python的smtplib库尝试发送邮件时，开发者有时会遇到[Errno 60] Operation timed out的错误。这个错误通常意味着Python程序在尝试连接SMTP服务器时，由于网络或服务器配置问题，无法在预设时间内建立连接。对于Gmail用户而言，这并非简单的网络延迟，而是更深层次的安全策略限制。
Gmail为了保护用户账户安全，默认情况下会阻止第三方应用（如通过smtplib编写的Python脚本）直接使用您的主密码登录并发送邮件。即使您的网络连接正常，并且SMTP服务器地址（smtp.gmail.com）和端口（587）配置正确，Gmail的安全系统仍然会拒绝未经授权的连接尝试，导致连接超时。
解决方案：配置Gmail账户
解决此问题的关键在于调整您的Gmail账户设置，以允许Python脚本通过SMTP协议进行连接。目前主要有两种方法：
方法一：使用应用密码（推荐且更安全）
如果您的Gmail账户启用了两步验证（2FA），那么生成并使用应用密码是最佳实践。应用密码是一个16位的代码，允许应用或设备访问您的Google账户，而无需使用您的主密码。它比直接启用“允许安全性较低的应用访问”更安全，因为它只授予特定应用有限的权限，并且可以在任何时候撤销。
立即学习“Python免费学习笔记（深入）”；
生成应用密码的步骤：
- 登录您的Google账户。
- 访问 Google 账户安全设置。
- 在“您登录 Google 的方式”部分，找到“应用密码”选项。如果未启用两步验证，您需要先启用它。
- 点击“应用密码”，系统可能会要求您再次输入密码。
- 在“选择应用”下拉菜单中选择“邮件”，在“选择设备”下拉菜单中选择“其他（自定义名称）”，然后输入一个容易识别的名称（例如“Python邮件脚本”）。
- 点击“生成”。系统会显示一个16位的应用密码。请务必记下或复制此密码，因为它只会显示一次。
- 在您的Python代码中，将此16位应用密码用作connection.login()方法的密码。
方法二：启用“允许安全性较低的应用访问”（不推荐，即将弃用）
注意： Google已于2022年5月30日永久关闭了“允许安全性较低的应用访问”功能。此方法仅作为历史参考，不应再使用。如果您的账户仍然启用了此功能，强烈建议迁移到应用密码。
在过去，如果您的Gmail账户未启用两步验证，您可以选择启用“允许安全性较低的应用访问”。这会降低账户的安全性，允许任何知道您用户名和密码的应用连接。
过去的启用步骤（已失效）：
- 登录您的Google账户。
- 访问 允许安全性较低的应用访问。
- 将开关切换到“开启”。
Python代码实现与优化
以下是一个经过优化的Python代码示例，演示如何使用smtplib发送邮件，并结合环境变管理邮件凭据，以增强安全性。
import smtplib
import os
from dotenv import load_dotenv # 用于从.env文件加载环境变量，如果需要
# 推荐使用dotenv加载环境变量，或者直接设置系统环境变量
# load_dotenv() # 如果使用.env文件，请取消注释
# 从环境变量中获取邮件凭据
# 强烈建议将邮箱和密码存储在环境变量中，而不是硬编码
EMAIL_USER = os.getenv("EMAIL_USER")
EMAIL_PASSWORD = os.getenv("EMAIL_PASSWORD") # 这里应是您的Gmail应用密码
# 检查环境变量是否已设置
if not EMAIL_USER or not EMAIL_PASSWORD:
print("错误：请设置EMAIL_USER和EMAIL_PASSWORD环境变量。")
print("对于Gmail，EMAIL_PASSWORD应为您的16位应用密码。")
exit()
# 配置邮件发送信息
sender_email = EMAIL_USER # 发件人邮箱，通常与EMAIL_USER相同
receiver_email = "recipient@example.com" # 收件人邮箱
subject = "Hello from Python SMTP"
body = """\
This is a test email sent from Python using smtplib.
It demonstrates sending mail with proper Gmail authentication.
"""
# 组合邮件内容
message = f"Subject: {subject}\n\n{body}"
try:
# 使用with语句确保连接正确关闭
# Gmail SMTP服务器：smtp.gmail.com，端口：587
with smtplib.SMTP("smtp.gmail.com", port=587) as connection:
# 启动TLS加密连接，这是SMTP安全通信的标准做法
connection.starttls()
# 使用您的Gmail账户和应用密码登录
connection.login(user=EMAIL_USER, password=EMAIL_PASSWORD)
# 发送邮件
connection.sendmail(from_addr=sender_email, to_addrs=receiver_email, msg=message)
print("邮件发送成功！")
except smtplib.SMTPAuthenticationError as e:
print(f"SMTP认证失败：请检查您的邮箱和应用密码是否正确。错误信息: {e}")
except smtplib.SMTPConnectError as e:
print(f"SMTP连接失败：请检查网络连接或SMTP服务器地址/端口。错误信息: {e}")
except Exception as e:
print(f"发生未知错误: {e}")
如何设置环境变量（以macOS/Linux为例）：
在终端中执行：
export EMAIL_USER="your_gmail_address@gmail.com" export EMAIL_PASSWORD="your_16_digit_app_password"
注意： 这样设置的环境变量只在当前终端会话中有效。若要永久设置，请将其添加到~/.bashrc, ~/.zshrc或~/.profile文件中。 对于Windows用户，可以通过系统属性设置环境变量，或在PowerShell/CMD中使用$env:EMAIL_USER="value"。
注意事项与最佳实践
- 安全性： 永远不要在代码中硬编码敏感信息（如邮箱和密码）。使用环境变量、配置文件或秘密管理服务是更安全的做法。
- 两步验证： 强烈建议为您的Google账户启用两步验证。这不仅能提高账户安全性，也是使用应用密码的前提。
- 网络连接： 确保您的设备能够访问smtp.gmail.com的587端口。防火墙或代理设置可能会阻止此连接。可以尝试使用ping smtp.gmail.com或telnet smtp.gmail.com 587（如果安装了telnet）来测试连接性。
- 错误处理： 使用try-except块捕获smtplib可能抛出的各种异常，如SMTPAuthenticationError（认证失败）、SMTPConnectError（连接失败）等，以便更好地诊断问题。
-
SMTP服务器与端口：
- Gmail的SMTP服务器地址是smtp.gmail.com。
- 推荐的端口是587，配合starttls()方法启用TLS加密。
- 也可以使用端口465，配合SMTP_SSL()类直接建立SSL连接。
总结
[Errno 60] Operation timed out错误在使用Python smtplib发送Gmail邮件时是一个常见问题，其根本原因在于Gmail的安全策略。通过为您的Google账户生成并使用应用密码，您可以安全有效地解决此问题。请务必遵循安全最佳实践，将敏感凭据存储在环境变量中，并确保您的代码能够正确处理可能发生的各种错误。通过这些步骤，您将能够成功地使用Python脚本发送邮件。
