本文详解 flask 应用中接收 html 表单数据并通过 smtp（gmail）自动发送邮件的完整实现，重点解决“表单数据已接收但邮件未发出”的常见问题。
在 Flask 中实现联系表单（Contact Form）的邮件发送功能，关键在于前后端逻辑的完整串联：HTML 表单需正确提交至 Flask 路由，该路由必须显式调用邮件发送函数，并妥善处理请求方法、数据提取与异常反馈。从你提供的日志可见，POST /contact 请求已成功到达服务器（"POST /contact HTTP/1.1" 200 -），且控制台也打印出了表单字段值（如 Sara、[email protected] 等），这说明数据接收无误——但邮件未发出，根本原因正是：send_email() 函数未被实际调用。
✅ 正确的 Flask 路由实现（main.py）
你需要确保 /contact 路由同时支持 GET（渲染页面）和 POST（处理提交），并在 POST 分支中解析表单并调用 send_email()：
from flask import Flask, render_template, request, flash
import smtplib
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
app = Flask(__name__)
app.secret_key = 'your-secret-key-here' # 用于 flash 消息
def send_email(name, email, phone, message):
smtp_server = 'smtp.gmail.com'
smtp_port = 587
smtp_username = 'your-verified-gmail@gmail.com' # 替换为你的 Gmail 地址
smtp_password = 'your-app-password' # 替换为 Google App Password（非邮箱密码！）
from_email = smtp_username
to_email = 'recipient@example.com' # 接收邮件的目标地址
subject = f'New Contact Form Submission from {name}'
# 使用标准 MIME 格式构造邮件（更可靠，避免纯字符串格式问题）
msg = MIMEMultipart()
msg['From'] = from_email
msg['To'] = to_email
msg['Subject'] = subject
msg.attach(MIMEText(f"""\
Name: {name}
Email: {email}
Phone: {phone}
Message: {message}
""", 'plain'))
try:
with smtplib.SMTP(smtp_server, smtp_port) as server:
server.starttls() # 启用 TLS 加密
server.login(smtp_username, smtp_password)
server.send_message(msg)
return True
except Exception as e:
print(f"Email sending failed: {e}")
return False
@app.route('/contact', methods=['GET', 'POST'])
def contact():
if request.method == 'POST':
# ✅ 关键：从 request.form 提取数据
name = request.form.get('name', '').strip()
email = request.form.get('email', '').strip()
phone = request.form.get('phone', '').strip()
message = request.form.get('message', '').strip()
# 基础验证（可选但推荐）
if not all([name, email, message]):
flash('Please fill in all required fields.', 'error')
return render_template('contact.html', msg_sent=False)
# ✅ 关键：显式调用 send_email 并检查结果
if send_email(name, email, phone, message):
flash('Your message has been sent successfully!', 'success')
return render_template('contact.html', msg_sent=True)
else:
flash('Failed to send email. Please try again later.', 'error')
return render_template('contact.html', msg_sent=False)
# GET 请求：渲染空表单
return render_template('contact.html', msg_sent=False)? 重要注意事项
- Gmail App Password 必须启用两步验证后生成：直接使用邮箱密码会失败（Google 已禁用“不安全应用访问”）。前往 Google Account → Security → App passwords 生成 16 位密码。
- 不要硬编码敏感信息：生产环境应使用环境变量（如 os.getenv('SMTP_PASSWORD')）管理账号密码。
- 使用 MIMEText/MIMEMultipart 构造邮件：比拼接原始字符串更规范，兼容性更好，避免因换行、编码等问题导致邮件发送失败或内容乱码。
- 添加错误处理与用户反馈：try/except 捕获 SMTP 异常，并通过 flash() 向用户提示成功或失败状态（需在模板中渲染 get_flashed_messages()）。
-
确保 contact.html 正确显示提示：在模板 中适当位置添加：
{% with messages = get_flashed_messages(with_categories=true) %} {% if messages %} {% for category, message in messages %} <div class="alert alert-{{ 'success' if category == 'success' else 'danger' }}">{{ message }}</div> {% endfor %} {% endif %} {% endwith %}
✅ 总结
表单数据“能打印却发不出邮件”，90% 的原因是：Flask 路由收到了 POST 请求，但忘记在代码中执行 send_email(...) 这一行。务必检查你的 /contact 视图函数是否包含对邮件函数的显式调用，并确保其位于 request.method == 'POST' 分支内。配合 MIME 邮件构造、App Password 配置和基础错误处理，即可稳定实现联系表单的邮件通知功能。
