Flask 表单数据提交后如何正确调用邮件发送函数实现联系表单功能_技术教程

本文详解 flask 中如何将 html 表单提交的数据（姓名、邮箱、电话、消息）安全可靠地通过 gmail smtp 发送至指定邮箱，重点解决“表单能接收数据但邮件未发出”的常见问题。

在 Flask 应用中实现联系表单的邮件发送功能，关键在于后端路由逻辑的完整性：仅定义 send_email() 函数是不够的，必须在处理 POST 请求的视图函数（如 contact()）中显式调用该函数并传入表单数据。从日志可见，POST /contact 请求已成功触发（"POST /contact HTTP/1.1" 200 -），且控制台输出了表单内容（如 Sara、[email protected] 等），说明数据已正确接收；但邮件未发出，根本原因正是 send_email() 函数未被调用。

✅ 正确的后端实现（main.py）

确保你的 contact() 视图函数完整包含以下逻辑：

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'  # 用于 flash 消息（可选）

@app.route('/contact', methods=['GET', 'POST'])
def contact():
    if request.method == 'POST':
        # 1. 获取表单数据
        name = request.form.get('name', '').strip()
        email = request.form.get('email', '').strip()
        phone = request.form.get('phone', '').strip()
        message = request.form.get('message', '').strip()

        # 2. 基础校验（建议添加）
        if not all([name, email, message]):
            flash('Please fill in all required fields.', 'error')
            return render_template('contact.html', msg_sent=False)

        try:
            # 3. 调用邮件发送函数 —— 这是缺失的关键步骤！
            send_email(name, email, phone, message)
            return render_template('contact.html', msg_sent=True)
        except Exception as e:
            print(f"Email sending failed: {e}")
            flash('Failed to send message. Please try again.', 'error')
            return render_template('contact.html', msg_sent=False)

    # GET 请求：渲染初始页面
    return render_template('contact.html', msg_sent=False)

def send_email(name, email, phone, message):
    smtp_server = 'smtp.gmail.com'
    smtp_port = 587
    smtp_username = 'your_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}\nEmail: {email}\nPhone: {phone}\nMessage:\n{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)  # 推荐用 send_message() 替代 sendmail()
        print("✅ Email sent successfully.")
    except Exception as e:
        print(f"❌ SMTP Error: {e}")
        raise

? 关键注意事项

Gmail App Password 是必需的：
自 2025 年起，Google 已禁用「低安全性应用访问」。你必须：
1. 在 Google 账户安全设置中开启「两步验证」；
2. 在「App passwords」页面生成一个 16 位专用密码（选择「Mail」→「Other」），将此密码填入 smtp_password，而非你的 Gmail 登录密码。
避免硬编码敏感信息：
生产环境务必使用环境变量管理 smtp_username 和 smtp_password：
```
import os
smtp_username = os.getenv('GMAIL_USER')
smtp_password = os.getenv('GMAIL_APP_PASSWORD')
```
HTML 模板需支持状态反馈：
你的 contact.html 中已正确使用 msg_sent 变量控制提示文案（{% if msg_sent %}），确保 render_template() 调用时传入该参数。