第 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 apppython
# 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:80005.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 = Truepython
# 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 消息。三条规矩:
- 生产必须从环境变量读,代码里的默认值只给开发用;
- 换个 key 会让所有已登录用户掉线(签名失效)——这是预期行为;
- 不要提交到仓库,
.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 三个坑
| 坑 | 现象 | 修法 |
|---|---|---|
| 模板找不到 | TemplateNotFound | Flask(__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 拆成按业务分的模块,还要处理前缀、模板与静态文件。