当前位置：首页 > news >正文

网站配置谷歌邮箱 (Gmail) 自动发件完整教程（2026 最新版）

news 2026/3/26 22:33:26

在网站开发中，自动发邮件是刚需功能：用户注册验证、找回密码、订单通知、系统预警都离不开。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
加密方式	STARTTLS（587）/ SSL（465）
用户名	你的完整 Gmail 地址（xxx@gmail.com）
密码	16 位应用专用密码
身份验证	必须开启 (Auth=true)

优先用587+TLS，兼容性最好；465 端口适合老旧系统 / 防火墙受限环境。

三、主流框架 / 语言配置示例（直接复制）

1. SpringBoot 配置（最常用）

① pom.xml 引入依赖

xml

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-mail</artifactId> </dependency>

② application.yml 配置

yaml

spring: mail: host: smtp.gmail.com port: 587 username: your-email@gmail.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-email@gmail.com"); message.setTo(to); message.setSubject(subject); message.setText(text); mailSender.send(message); } }

2. PHP 配置（原生 / ThinkPHP/Laravel）

php

运行

<?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-email@gmail.com'; $mail->Password = '16位应用专用密码'; $mail->SMTPSecure = 'tls'; $mail->Port = 587; // 收件人 $mail->setFrom('your-email@gmail.com', '发件人名称'); $mail->addAddress('to@example.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-email@gmail.com" password = "16位应用专用密码" receiver = "to@example.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 Host：smtp.gmail.com
- Encryption：TLS
- SMTP Port：587
- SMTP Username：Gmail 邮箱
- SMTP Password：应用专用密码
保存并发送测试邮件，收到即成功。

五、高频报错与解决方案（必看）

Authentication failed原因：密码错误 / 未用应用专用密码 / 两步验证未开解决：重新生成 16 位应用专用密码，检查两步验证状态
Connection timed out / 无法连接原因：国内网络限制、端口被防火墙封禁解决：确保服务器可访问谷歌；改用 465 端口；企业 / 出海服务器优先使用
发送被拒：550 5.7.1 Unauthorized原因：发件人地址与 SMTP 用户名不一致解决：代码里 setFrom 必须和配置的 Gmail 邮箱相同
进入垃圾箱解决：邮件不要全是链接 / 敏感词；添加退订链接；稳定 IP 发送