如何在 Flask 中正确处理表单提交并发送邮件

本文详解 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 配置和基础错误处理，即可稳定实现联系表单的邮件通知功能。