在网站开发中自动发邮件是刚需功能用户注册验证、找回密码、订单通知、系统预警都离不开。Gmail 凭借高送达率、全球可用、免费 SMTP 服务成为个人 / 中小项目、出海应用的首选发件邮箱。但很多同学踩坑直接用账号密码连不上、被谷歌拦截、端口 / 加密写错。本文基于 2026 年谷歌最新安全规则从零到一教你配置 Gmail SMTP 自动发件覆盖SpringBoot/PHP/Python/ 通用 CMS附可直接复制的代码与排错方案。一、核心前提Gmail 账号安全设置必须做2022 年起谷歌关闭 “低安全性应用” 开关必须开启两步验证 生成应用专用密码否则无法用 SMTP 发件。1. 开启两步验证登录 Google 账号 → 进入【安全性】找到【两步验证】→ 开启按提示绑定手机号 / 验证器2. 生成应用专用密码SMTP 登录用回到安全性页面 → 搜索【应用专用密码】选择应用邮件→ 设备其他自定义名称如 “网站 SMTP”点击【生成】→ 得到16 位无空格密码复制保存只显示一次重要SMTP 配置里的密码 应用专用密码不是你的谷歌登录密码3. 启用 IMAP/POP3可选但推荐Gmail 设置 → 转发和 POP/IMAP → 启用 IMAP → 保存二、Gmail SMTP 标准配置参数通用所有平台所有网站 / 框架配置都用这组参数直接复制表格配置项参数值SMTP 服务器smtp.gmail.com端口 (TLS 推荐)587端口 (SSL)465加密方式STARTTLS587/ SSL465用户名你的完整 Gmail 地址xxxgmail.com密码16 位应用专用密码身份验证必须开启 (Authtrue)优先用587TLS兼容性最好465 端口适合老旧系统 / 防火墙受限环境。三、主流框架 / 语言配置示例直接复制1. SpringBoot 配置最常用① pom.xml 引入依赖xmldependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-mail/artifactId /dependency② application.yml 配置yamlspring: mail: host: smtp.gmail.com port: 587 username: your-emailgmail.com password: 你的16位应用专用密码 default-encoding: UTF-8 properties: mail: smtp: auth: true starttls: enable: true required: true ssl: trust: smtp.gmail.com③ 发送代码Service 层java运行Service public class MailService { Resource private JavaMailSender mailSender; // 发送简单文本邮件 public void sendSimpleMail(String to, String subject, String text) { SimpleMailMessage message new SimpleMailMessage(); message.setFrom(your-emailgmail.com); message.setTo(to); message.setSubject(subject); message.setText(text); mailSender.send(message); } }2. PHP 配置原生 / ThinkPHP/Laravelphp运行?php use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\Exception; require PHPMailer/src/Exception.php; require PHPMailer/src/PHPMailer.php; require PHPMailer/src/SMTP.php; $mail new PHPMailer(true); try { // 服务器配置 $mail-isSMTP(); $mail-Host smtp.gmail.com; $mail-SMTPAuth true; $mail-Username your-emailgmail.com; $mail-Password 16位应用专用密码; $mail-SMTPSecure tls; $mail-Port 587; // 收件人 $mail-setFrom(your-emailgmail.com, 发件人名称); $mail-addAddress(toexample.com); // 内容 $mail-isHTML(true); $mail-Subject 网站验证邮件; $mail-Body 您的验证码是123456; $mail-send(); echo 邮件发送成功; } catch (Exception $e) { echo 邮件发送失败{$mail-ErrorInfo}; } ?3. Python 配置python运行import smtplib from email.mime.text import MIMEText def send_email(): smtp_server smtp.gmail.com smtp_port 587 sender your-emailgmail.com password 16位应用专用密码 receiver toexample.com msg MIMEText(Python通过Gmail SMTP发送邮件, plain, utf-8) msg[From] sender msg[To] receiver msg[Subject] 测试邮件 with smtplib.SMTP(smtp_server, smtp_port) as server: server.starttls() server.login(sender, password) server.sendmail(sender, receiver, msg.as_string()) send_email()四、通用 CMS / 后台系统配置WordPress / 宝塔 / 独立后台以宝塔面板 WordPress为例安装邮件插件WP Mail SMTP/FluentSMTP选择 SMTP 提供商Other SMTP填入参数SMTP Hostsmtp.gmail.comEncryptionTLSSMTP Port587SMTP UsernameGmail 邮箱SMTP Password应用专用密码保存并发送测试邮件收到即成功。五、高频报错与解决方案必看Authentication failed原因密码错误 / 未用应用专用密码 / 两步验证未开解决重新生成 16 位应用专用密码检查两步验证状态Connection timed out / 无法连接原因国内网络限制、端口被防火墙封禁解决确保服务器可访问谷歌改用 465 端口企业 / 出海服务器优先使用发送被拒550 5.7.1 Unauthorized原因发件人地址与 SMTP 用户名不一致解决代码里 setFrom 必须和配置的 Gmail 邮箱相同进入垃圾箱解决邮件不要全是链接 / 敏感词添加退订链接稳定 IP 发送六、使用建议与限制免费版 Gmail 限制每日最多发送500 封适合个人 / 小型项目企业版 Gmail (Workspace)每日 2000 封支持自定义域名发件更正规安全建议不要硬编码密码使用环境变量 / 配置中心加密存储替代方案大批量发送建议用 SendGrid/Mailgun避免 Gmail 账号受限总结Gmail SMTP 配置核心就 3 步开两步验证→生成应用密码→填对 587/TLS 参数。本文提供的配置与代码可直接用于生产环境适配 Java/PHP/Python 及各类 CMS一次配置终身使用。如果你的网站是出海项目Gmail 是零成本、高可靠的自动发件最优解如果是国内用户为主建议搭配 QQ 邮箱 / 163 邮箱备用。