Flask项目中如何正确将SECRET_KEY传递至mail.py模块的函数？

我已经在settings.py模块的Config类中定义了所有配置项，代码如下：

import os, secrets
basedir = os.path.abspath(os.path.dirname(__file__))

class Config():
    SECRET_KEY = secrets.token_hex(16)
    SQLALCHEMY_DATABASE_URI ='sqlite:///' + os.path.join(basedir, 'sqlitedb/data.sqlite')
    SQLALCHEMY_TRACK_MODIFICATIONS = False
    MAIL_SERVER = 'smtp.gmail.com'
    MAIL_PORT = 587
    MAIL_USE_TLS = True
    ...........

主模块app.py通过以下方式加载该配置：

from flask import Flask
from MyProject.extensions import db, mail, bootstrap, migrate
from MyProject.settings import Config
from werkzeug.security import generate_password_hash, check_password_hash


def create_app():
    app = Flask(__name__.split('.')[0])
    app.url_map.strict_slashes = False
    app.config.from_object(Config)
    register_extensions(app)
    register_blueprints(app)
    return app

我的需求是将SECRET_KEY值传递至mail.py模块中的send_congrats_email函数，该函数当前代码如下：

from itsdangerous import URLSafeTimedSerializer
from Myproject.app import mail
from Myproject import app
def send_congrats_email(user):
    confirm_serializer = URLSafeTimedSerializer(app.config['SECRET_KEY'])
    confirm_url = url_for(
        'confirm_email',
        token=confirm_serializer.dumps(user, salt='email-confirmation-salt'),
        _external=True)

    send_email('[Congrats] You are registered',
               sender= "NICOLAS",
               recipients=[user.email],
               html_body=render_template('users/email_confirmation.html',
                                         user=user))

请问完成该需求的正确方式是什么？

方法1：使用Flask的current_app（推荐） #

Flask的current_app对象会在请求/应用上下文存在时指向当前运行的Flask实例，可直接获取已加载的配置，同时避免循环引用问题。修改mail.py代码如下：

from itsdangerous import URLSafeTimedSerializer
from flask import current_app, url_for, render_template
from Myproject.extensions import mail  # 从extensions导入mail，避免循环引用

def send_congrats_email(user):
    # 从current_app获取当前应用的SECRET_KEY
    confirm_serializer = URLSafeTimedSerializer(current_app.config['SECRET_KEY'])
    confirm_url = url_for(
        'confirm_email',
        token=confirm_serializer.dumps(user.email, salt='email-confirmation-salt'),  # 建议序列化用户唯一标识（如email）而非整个对象
        _external=True)

    send_email('[Congrats] You are registered',
               sender= "NICOLAS",
               recipients=[user.email],
               html_body=render_template('users/email_confirmation.html',
                                         user=user))

注意：调用该函数时需确保应用上下文存在（比如在视图函数、CLI命令中，或手动用app.app_context()包裹调用）。

方法2：直接从Config类导入SECRET_KEY #

如果你的配置类没有多环境区分，可直接从Config类读取SECRET_KEY：

from itsdangerous import URLSafeTimedSerializer
from flask import url_for, render_template
from Myproject.extensions import mail
from MyProject.settings import Config

def send_congrats_email(user):
    confirm_serializer = URLSafeTimedSerializer(Config.SECRET_KEY)
    confirm_url = url_for(
        'confirm_email',
        token=confirm_serializer.dumps(user.email, salt='email-confirmation-salt'),
        _external=True)

    send_email('[Congrats] You are registered',
               sender= "NICOLAS",
               recipients=[user.email],
               html_body=render_template('users/email_confirmation.html',
                                         user=user))

这种方式无需依赖Flask上下文，但如果后续有DevelopmentConfig、ProductionConfig等子类配置，直接导入Config会拿到默认值而非当前环境配置，因此仅推荐单配置场景使用。

方法3：通过函数参数传递SECRET_KEY #

在调用send_congrats_email时，将SECRET_KEY作为参数传入：

# 示例：在视图函数中调用
from flask import current_app
from Myproject.mail import send_congrats_email

def register():
    # ... 用户创建逻辑
    send_congrats_email(user, secret_key=current_app.config['SECRET_KEY'])

同时修改mail.py中的函数定义：

from itsdangerous import URLSafeTimedSerializer
from flask import url_for, render_template
from Myproject.extensions import mail

def send_congrats_email(user, secret_key):
    confirm_serializer = URLSafeTimedSerializer(secret_key)
    confirm_url = url_for(
        'confirm_email',
        token=confirm_serializer.dumps(user.email, salt='email-confirmation-salt'),
        _external=True)

    send_email('[Congrats] You are registered',
               sender= "NICOLAS",
               recipients=[user.email],
               html_body=render_template('users/email_confirmation.html',
                                         user=user))

这种方式耦合度低，但需要每次调用都传递参数，适合调用频率低的场景。

内容的提问来源于stack exchange，提问作者ussrback