本文详解 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 %}{{ message }}{% endfor %} {% endif %} {% endwith %}
✅ 总结
表单数据“能打印却发不出邮件”，90% 的原因是：Flask 路由收到了 POST 请求，但忘记在代码中执行 send_email(…) 这一行。务必检查你的 /contact 视图函数是否包含对邮件函数的显式调用，并确保其位于 request.method == ‘POST’ 分支内。配合 MIME 邮件构造、App Password 配置和基础错误处理，即可稳定实现联系表单的邮件通知功能。