Flask 轻量开发
Flask 3.1 蓝图与扩展:把小项目拆得刚刚好
Flask 的自由度是把双刃剑。用应用工厂、蓝图和明确的服务层,让 3 个路由长成 30 个路由时依然不乱。
Flask 3.1.3 在 2026 年 2 月发布。它依然是最轻的 Python Web 框架之一:核心很小,其他能力靠扩展补齐。这种设计适合小服务,但也意味着结构要自己规划。
应用工厂是起点
def create_app(config_object: str = "config.Production") -> Flask:
app = Flask(__name__)
app.config.from_object(config_object)
db.init_app(app)
register_blueprints(app)
register_error_handlers(app)
return app
工厂函数让测试可以传入不同的配置,也让同一个代码库同时支持开发、测试和生产实例。不要在模块顶层创建 app = Flask(__name__) 再到处 import。
按业务拆蓝图,不按技术拆
常见错误是建一个 api_blueprint 装下所有接口。更好的切法是按业务边界:orders、users、reports,每个蓝图自带路由、校验与错误码。
bp = Blueprint("orders", __name__, url_prefix="/api/orders")
@bp.post("")
def create_order():
payload = CreateOrder.model_validate(request.get_json(silent=True) or {})
return jsonify(order_service.create(payload)), 201
视图函数只负责协议层:解析输入、调用服务、组织响应。业务逻辑放进 service 模块,才能脱离 HTTP 上下文单测。
扩展要克制
- 每个扩展都要问:它是否主动维护?是否支持当前 Flask 与 Python 版本?
- 能用一个函数解决的,不要引入一个扩展。
- 数据库访问优先选 SQLAlchemy 2.x 风格,类型提示更完整。
- 需要异步接口时评估 ASGI 框架,Flask 的异步视图不等于整个栈都异步。
上线之前
用 Gunicorn 或 uWSGI 承载 WSGI 应用,进程数按 CPU 与内存实测决定;反向代理层处理 TLS、压缩和静态文件。健康检查接口只返回状态,不做数据库写入。
