Flask 应用中使用 Flask-Mail 发送邮件时出现 ConnectionRefusedError 和 500 Internal Server Error，根本原因是 Mail(app) 初始化过早——在 Flask 配置项（如 MAIL_SERVER、MAIL_PORT 等）设置完成前就创建了 Mail 实例。
flask 应用中使用 flask-mail 发送邮件时出现 `connectionrefusederror` 和 `500 internal server error`，根本原因是 `mail(app)` 初始化过早——在 flask 配置项（如 `mail_server`、`mail_port` 等）设置完成前就创建了 mail 实例。
在 Flask 中，flask_mail.Mail 实例依赖于 app.config 中预设的 SMTP 配置参数。若在配置项写入前调用 Mail(app)，Flask-Mail 将使用默认（空或无效）配置初始化底层 SMTP 连接器，导致后续 mail.send() 调用时因无法解析服务器地址或端口而抛出 ConnectionRefusedError: [Errno 61] Connection refused。同时，视图函数 contact() 缺少对 POST 成功/失败路径的统一响应返回，引发 TypeError: The view function [...] did not return a valid response ——这也是 500 错误的第二重原因。
✅ 正确初始化顺序（关键修复）
必须先完成所有 app.config 设置，再初始化 Mail 实例：
from flask import Flask, render_template, request from flask_mail import Mail, Message from config import sender_mail_username, sender_mail_password, recipient_mail_username app = Flask(__name__) # ✅ 步骤1：先配置所有 MAIL_* 参数 app.config["MAIL_SERVER"] = "smtp.gmail.com" app.config["MAIL_PORT"] = 465 app.config["MAIL_USE_TLS"] = False app.config["MAIL_USE_SSL"] = True app.config["MAIL_USERNAME"] = sender_mail_username app.config["MAIL_PASSWORD"] = sender_mail_password # ✅ 步骤2：再初始化 Mail 实例（此时配置已生效） mail = Mail(app)
⚠️ 注意：mail = Mail(app) 绝不可放在 app.config 赋值之前，否则配置不会被读取。
✅ 补充：修复视图函数返回逻辑
原代码中 contact() 视图在 POST 时执行发送逻辑但未返回响应；而 GET 请求（首次访问 /）会跳过 if request.method == "POST" 直接渲染 sent.html ——这显然不符合预期，且导致无返回值错误。应明确区分请求方法，并确保所有执行路径均有返回值：
@app.route("/", methods=["GET", "POST"])
def contact():
if request.method == "POST":
try:
email = request.form.get("email")
subject = request.form.get("subject")
message = request.form.get("message")
# recipients 必须是字符串列表（即使只有一个收件人）
msg = Message(
subject="UNIFINITY Contact Form submission",
sender=sender_mail_username,
recipients=[recipient_mail_username], # ✅ 注意：必须是 list!
body=f"Email: {email}\nSubject: {subject}\n\n{message}"
)
mail.send(msg)
return render_template("sent.html", status="success")
except Exception as e:
# 记录错误便于调试（生产环境建议用 logging）
print(f"Email sending failed: {e}")
return render_template("sent.html", status="error")
# GET 请求：返回主页（含联系表单）
return render_template("home.html")
? Gmail 配置补充说明（安全要求）
- 若使用 Gmail SMTP，请确保：
- 已开启 Google 账户的 “两步验证”，并为应用生成 App Password（而非直接使用账户密码）；
- 在 config.py 中填写该 16 位 App Password 到 sender_mail_password；
- MAIL_USERNAME 应为完整邮箱地址（如 yourname@gmail.com）；
- recipients 参数必须是字符串列表（例如 ["admin@unifinity.com"]），不可为字符串。
? 测试建议
部署前，可在 Python shell 中快速验证 SMTP 连通性：
import smtplib
server = smtplib.SMTP_SSL("smtp.gmail.com", 465)
server.login("your@gmail.com", "your_app_password") # 使用 App Password
server.quit()
若此脚本成功运行，说明网络与凭据无误，问题必在 Flask-Mail 初始化或视图逻辑中。
遵循以上修正后，联系表单将稳定发送邮件，彻底规避 ConnectionRefusedError 与 500 Internal Server Error。
