Skip to content
Lv3Flask 速成进度 5 / 8

第 5 章:应用工厂与配置分层 ​

单文件写 Flask,写到第三天一定会遇到循环导入。工厂模式不是"高级写法",是"能继续写下去"的前提。


学习目标 ​

  • 说清单文件写法会撞上的三个问题
  • 会用 create_app 组织应用,并解释它为什么能解决循环导入
  • 会把配置分成开发、测试、生产三层
  • 知道扩展为什么必须延迟初始化

5.1 单文件会撞上什么 ​

python
# app.py
from flask import Flask
from views import user_bp        # ① 导入视图
app = Flask(__name__)
app.register_blueprint(user_bp)

# views.py
from app import app               # ② 视图又导回 app —— 循环

三个后果:

问题表现
循环导入启动时 ImportError 或拿到半初始化的模块
测试难测试要复用同一个 app,配置改了就互相污染
多实例不可能想同时跑"测试配置"和"生产配置"两份应用,做不到

5.2 create_app:把"创建"变成函数 ​

python
# app/__init__.py
from flask import Flask
from .extensions import db, migrate
from .views import main_bp, user_bp

def create_app(config_object="app.config.Config"):
    app = Flask(__name__)
    app.config.from_object(config_object)

    db.init_app(app)              # 扩展在"有 app"之后才绑定
    migrate.init_app(app, db)

    app.register_blueprint(main_bp)
    app.register_blueprint(user_bp, url_prefix="/users")
    return app
python
# wsgi.py
from app import create_app
app = create_app()
bash
flask --app "app:create_app()" run --debug
gunicorn "app:create_app()" -w 4 -b 0.0.0.0:8000
同样是两层依赖,一个成环,一个单向单文件:app 与 views 互相导入app.pyviews.pyimport bpfrom app import app启动即报错,或拿到半初始化的对象工厂:全部依赖 create_appcreate_app()views.pyextensionswsgi.py视图只导出蓝图,扩展只导出实例:谁都不 import app工厂的三个好处:循环导入断开、测试能各自新建 app、同一份代码能跑不同配置。代价是多一层目录结构,小脚本没必要用,超过 5 个视图就该用。

5.3 配置分三层 ​

python
# app/config.py
import os

class Config:
    SECRET_KEY = os.environ.get("SECRET_KEY", "dev-only-change-me")
    SQLALCHEMY_DATABASE_URI = os.environ.get("DATABASE_URL", "sqlite:///app.db")
    SQLALCHEMY_TRACK_MODIFICATIONS = False
    JSON_AS_ASCII = False

class DevelopmentConfig(Config):
    DEBUG = True
    SQLALCHEMY_ECHO = True

class TestingConfig(Config):
    TESTING = True
    SQLALCHEMY_DATABASE_URI = "sqlite:///:memory:"

class ProductionConfig(Config):
    DEBUG = False
    SESSION_COOKIE_SECURE = True
    SESSION_COOKIE_HTTPONLY = True
python
# wsgi.py
import os
from app import create_app

config = {
    "development": "app.config.DevelopmentConfig",
    "testing": "app.config.TestingConfig",
    "production": "app.config.ProductionConfig",
}[os.environ.get("APP_ENV", "development")]

app = create_app(config)

配置的优先级要自己想清楚,从低到高通常是:默认值 → 配置类 → 环境变量 → 命令行。别出现"两个地方都能改同一个值"的情况。


5.4 扩展为什么要延迟初始化 ​

python
# app/extensions.py
from flask_sqlalchemy import SQLAlchemy
from flask_migrate import Migrate

db = SQLAlchemy()          # 此时还没有 app
migrate = Migrate()
python
# app/__init__.py 里
db.init_app(app)           # 有了 app 才绑定

原因:扩展模块不能 import app,否则又回到循环导入。init_app 模式让扩展先存在、后绑定,所有 Flask 扩展都遵循这套约定。


5.5 SECRET_KEY 到底管什么 ​

它用于签名 session cookie、CSRF token、flash 消息。三条规矩:

  1. 生产必须从环境变量读,代码里的默认值只给开发用;
  2. 换个 key 会让所有已登录用户掉线(签名失效)——这是预期行为;
  3. 不要提交到仓库,.env 进 .gitignore。
python
app.config["SECRET_KEY"] = os.environ["SECRET_KEY"]   # 缺失就直接报错,好过用默认值上生产

5.6 目录长什么样 ​

myapp/
├── app/
│   ├── __init__.py          # create_app
│   ├── config.py            # 配置类
│   ├── extensions.py        # db / migrate / login_manager
│   ├── models/
│   ├── views/
│   ├── templates/
│   └── static/
├── migrations/              # flask db init 生成
├── tests/
├── wsgi.py
├── requirements.txt
└── .env                     # 不进仓库

5.7 三个坑 ​

坑现象修法
模板找不到TemplateNotFoundFlask(__name__) 传的包名不对,或模板不在该包下
扩展用了才发现没绑定RuntimeError: app not registered忘了 init_app
测试互相污染上一个用例的数据出现在下一个每个 fixture 新建 app + 内存库

本章小结 ​

要点说明
单文件问题循环导入、测试难、无法多实例
工厂create_app() 返回 app,全局不再有 app 变量
配置三层:默认 / 类 / 环境变量,优先级要明确
扩展init_app 延迟绑定,扩展模块不 import app
SECRET_KEY生产从环境变量读,别用默认值
启动flask --app "app:create_app()",Gunicorn 同写法

下一章 ​

蓝图:把一个 views.py 拆成按业务分的模块,还要处理前缀、模板与静态文件。

本文阅读--次|全站访问--次|访客--人