flask发送qq邮箱验证码成功的关键在于正确配置授权码、端口与加密方式：mail_password必须为qq邮箱smtp授权码而非登录密码；tls配587端口或ssl配465端口，二者不可同时启用；需确保mail.init_app(app)完成初始化，并用redis缓存验证码。

Flask 发送 QQ 邮箱验证码，核心不是“能不能发”，而是“配置对不对、授权码用没用对、端口和加密方式配不匹配”。绝大多数失败都卡在这三步，而不是代码逻辑。

QQ邮箱必须用授权码，不能用登录密码

这是最常踩的坑：在 config.py 里填 MAIL_PASSWORD 时，直接填了 QQ 账号密码——这必然失败。

• 必须去 QQ 邮箱网页版 → 设置 → 账户 → “POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务” → 开启 SMTP 服务
• 开启后会弹出二维码或短信验证，通过后生成一串 16 位字母数字组合，这就是 授权码
• MAIL_PASSWORD 的值必须是这个授权码，不是邮箱密码，也不是手机验证码

端口和加密方式必须严格对应

QQ 邮箱只支持两种组合，填错一个就连接超时或被拒绝：

Flask 3.0.2

Flask 3.0.2 是 Flask 的官方历史稳定版本，下载地址使用 PyPI wheel 包直链，适合指定版本安装和项目环境复现。

下载

• 用 MAIL_USE_TLS = True → MAIL_PORT = 587
• 用 MAIL_USE_SSL = True → MAIL_PORT = 465
• 二者不能同时为 True；也不能都为 False（QQ 邮箱不接受明文）
• MAIL_SERVER 必须是 "smtp.qq.com"，大小写敏感，不能漏掉 smtp.

发送逻辑里别漏掉 app_context 或初始化顺序

如果你在视图函数里调用 mail.send() 报 RuntimeError: working outside of application context，说明 Flask-Mail 没绑定到 app 实例上。

• 确保 exts.py 中创建了 mail = Mail()
• 确保 app.py 或工厂函数里调用了 mail.init_app(app)
• 测试时如果用 flask shell 手动发邮件，得先手动进上下文：

  with app.app_context():<br>  mail.send(msg)

验证码生成和存储建议用缓存而非数据库

邮箱验证码本质是临时凭证，有效期短（通常 5–10 分钟），写数据库反而增加延迟和冗余。

• 优先用 redis 或 memcache：以 email 为 key，captcha + 过期时间存 value
• 避免用 random.sample(string.digits*4, 4) 这种写法——string.digits*4 是 "01234567890123456789..."，重复元素可能导致 sample 报错；改用 random.choices(string.digits, k=6) 更安全
• 发送成功后记得返回明确状态（如 JSON {"code": 0, "msg": "已发送"}），前端才好控制倒计时按钮禁用

真正容易被忽略的是授权码的时效性和使用限制：一个授权码只能用于一个邮箱账户，且一旦在其他设备重复启用 SMTP，旧授权码会立即失效。每次调试建议重新生成一个，别复用。