62 lines
2.4 KiB
Python
62 lines
2.4 KiB
Python
|
"""邮件发送工具（基于标准库 smtplib，465 端口 SSL）。
|
|||
|
|
|
|||
|
|
配置来自 app.config.setting.settings（SMTP_HOST/PORT/USER/PASSWORD/FROM/FROM_NAME/TLS）。
|
|||
|
|
"""
|
|||
|
|
from email.header import Header
|
|||
|
|
from email.mime.text import MIMEText
|
|||
|
|
from smtplib import SMTP_SSL, SMTPException
|
|||
|
|
|
|||
|
|
from app.config.setting import settings
|
|||
|
|
from app.core.logger import logger
|
|||
|
|
|
|||
|
|
|
|||
|
|
def send_email(to_addr: str, subject: str, html_body: str) -> None:
|
|||
|
|
"""发送一封 HTML 邮件（同步，内部阻塞；服务层用线程池调用）。
|
|||
|
|
|
|||
|
|
参数:
|
|||
|
|
- to_addr (str): 收件人邮箱
|
|||
|
|
- subject (str): 邮件主题
|
|||
|
|
- html_body (str): HTML 正文
|
|||
|
|
|
|||
|
|
异常:
|
|||
|
|
- SMTPException: 发送失败时抛出，由调用方捕获并处理
|
|||
|
|
"""
|
|||
|
|
if not settings.SMTP_HOST or not settings.SMTP_USER:
|
|||
|
|
raise RuntimeError("SMTP 未配置：请在 .env 中设置 SMTP_HOST/SMTP_USER/SMTP_PASSWORD")
|
|||
|
|
|
|||
|
|
from_addr = settings.SMTP_FROM or settings.SMTP_USER
|
|||
|
|
display = settings.SMTP_FROM_NAME or from_addr
|
|||
|
|
# 显示名单独编码，邮箱地址保持 ASCII
|
|||
|
|
from_header = f"{Header(display, 'utf-8').encode()} <{from_addr}>"
|
|||
|
|
|
|||
|
|
msg = MIMEText(html_body, "html", "utf-8")
|
|||
|
|
msg["From"] = from_header
|
|||
|
|
msg["To"] = to_addr
|
|||
|
|
msg["Subject"] = Header(subject, "utf-8").encode()
|
|||
|
|
|
|||
|
|
with SMTP_SSL(settings.SMTP_HOST, settings.SMTP_PORT, timeout=10) as server:
|
|||
|
|
server.login(settings.SMTP_USER, settings.SMTP_PASSWORD)
|
|||
|
|
server.sendmail(from_addr, [to_addr], msg.as_string())
|
|||
|
|
|
|||
|
|
|
|||
|
|
def send_reset_code_email(to_addr: str, code: str, expire_seconds: int) -> None:
|
|||
|
|
"""发送找回密码验证码邮件。"""
|
|||
|
|
try:
|
|||
|
|
send_email(
|
|||
|
|
to_addr=to_addr,
|
|||
|
|
subject="【dpb】找回密码验证码",
|
|||
|
|
html_body=(
|
|||
|
|
f"<p>您好，</p>"
|
|||
|
|
f"<p>您正在申请找回密码，验证码为：</p>"
|
|||
|
|
f'<p style="font-size:24px;font-weight:bold;color:#1677ff;letter-spacing:4px;">{code}</p>'
|
|||
|
|
f"<p>验证码 {expire_seconds // 60} 分钟内有效，请勿泄露给他人。</p>"
|
|||
|
|
f"<p>若非本人操作，请忽略本邮件。</p>"
|
|||
|
|
),
|
|||
|
|
)
|
|||
|
|
except SMTPException as e:
|
|||
|
|
logger.error(f"发送验证码邮件失败 -> {to_addr}: {e!s}")
|
|||
|
|
raise
|
|||
|
|
except Exception as e: # noqa: BLE001
|
|||
|
|
logger.error(f"发送验证码邮件异常 -> {to_addr}: {e!s}")
|
|||
|
|
raise
|