零基础入门python19：Flask账本第一步——应用工厂、蓝图和健康检查-北京尧图网络

零基础入门python19Flask账本第一步——应用工厂、蓝图和健康检查一、上一篇课后练习讲解Python 项目练习是给任务管理器增加优先级和截止日期。参考做法是先修改模型和 JSON 兼容读取再更新 CLI这提醒我们后端项目也应该先定义数据边界再组织入口和业务模块。上一篇课后练习完整答案上一篇要求增加delete_article管理员可以删除任意文章普通用户只能删除自己的文章。下面这份文件可以直接保存为permission_demo.py后运行它用内存列表模拟数据库先做权限判断再删除失败路径不会改变数据。fromdataclassesimportdataclassdataclassclassArticle:id:intauthor_id:inttitle:strdefdelete_article(articles:list[Article],article_id:int,actor_id:int,is_admin:bool)-bool:删除文章并返回是否成功查不到或无权时保持原列表不变。positionnext((ifori,articleinenumerate(articles)ifarticle.idarticle_id),None)ifpositionisNone:returnFalsearticlearticles[position]ifnotis_adminandarticle.author_id!actor_id:returnFalsearticles.pop(position)returnTruedefrun_checks()-None:articles[Article(1,10,作者的文章),Article(2,20,别人的文章)]assertdelete_article(articles,1,actor_id10,is_adminFalse)isTrueassert[article.idforarticleinarticles][2]snapshotlist(articles)assertdelete_article(articles,2,actor_id10,is_adminFalse)isFalseassertarticlessnapshotassertdelete_article(articles,2,actor_id99,is_adminTrue)isTrueassertarticles[]print(permission checks passed)if__name____main__:run_checks()运行python permission_demo.py预期输出permission checks passed。真实项目把pop换成事务中的DELETE并在查询时同时带上资源 id 和当前用户条件管理员分支必须经过单独的角色判断不能让客户端传is_admintrue自行提权。二、本篇完成什么创建 Flask 个人账本 API 的最小骨架跑通/health并理解为什么不把所有代码写进一个app.py。三、应用工厂# app/__init__.pyfromflaskimportFlaskfrom.extensionsimportdb,login_managerdefcreate_app(test_config:dict|NoneNone)-Flask:创建一个独立应用实例测试可以传入临时数据库配置。appFlask(__name__)app.config.from_mapping(SECRET_KEYdev-only-change-me,SQLALCHEMY_DATABASE_URIsqlite:///ledger.db,)iftest_config:app.config.update(test_config)db.init_app(app)login_manager.init_app(app)from.ledgerimportledger_bp app.register_blueprint(ledger_bp)app.get(/health)defhealth():return{status:ok,service:flask-ledger}returnapp应用工厂解决两个实际问题同一个代码可以创建开发、测试和生产实例导入模块时不会立刻连接生产数据库。db.init_app延迟绑定扩展避免循环导入。四、运行与测试python-m venv.venv.venv\\Scripts\\activate pip install-r requirements.txt python-cfrom app import create_app; print(create_app().url_map)python-m pytest-q预期健康检查返回 200测试通过。若出现Working outside of application context说明数据库操作发生在 Flask 应用上下文之外下一篇会专门解释上下文和扩展。五、课后练习增加/ready接口执行一次SELECT 1检查数据库并为数据库不可用时的响应写测试。下一篇会把配置、扩展和蓝图进一步拆开。项目增量应用工厂验收本篇让测试、开发和生产调用同一个 create_app。测试配置覆盖数据库 URI 和密钥导入模块时不连接生产数据库。defcreate_app(test_configNone):appFlask(__name__)app.config.from_mapping(SECRET_KEYchange-me,SQLALCHEMY_DATABASE_URIsqlite:///ledger.db)iftest_config:app.config.update(test_config)db.init_app(app)register_blueprints(app)returnapp验收健康检查 200、测试配置生效、应用上下文外访问数据库得到明确错误。课后练习增加 /ready 并测试数据库不可用场景。六、把“能启动”变成“可继续开发”的骨架刚才的代码看起来很少但它决定了后面十一个章节的接入方式。create_app是唯一的装配点配置在这里加载扩展在这里绑定蓝图在这里注册。业务模块只声明路由和函数不偷偷创建第二个Flask()。这样做的直接收益是测试可以创建一份内存数据库生产启动时则读取环境变量。在项目目录执行下面的命令先把目录建出来如果目录已经存在只需要核对文件内容mkdir app,testsniapp\__init__.py,app\extensions.py,app\ledger.py,tests\conftest.py-ItemType Fileapp/extensions.py只放“还没有绑定到应用”的对象fromflask_sqlalchemyimportSQLAlchemyfromflask_loginimportLoginManager dbSQLAlchemy()login_managerLoginManager()definit_extensions(app):在工厂中集中绑定第三方扩展避免模块导入时产生循环依赖。db.init_app(app)login_manager.init_app(app)init_extensions看似只是两行调用实际是生命周期边界。若把db SQLAlchemy(app)写在模块顶层pytest 导入测试文件时就会创建真实数据库连接连接失败会让连健康检查都无法执行。把绑定延迟到工厂后create_app({TESTING: True, ...})就能在每个测试中得到干净实例。七、用测试客户端验证装配而不是手工猜# tests/conftest.pyimportpytestfromappimportcreate_apppytest.fixture()defclient(tmp_path):db_filetmp_path/test.sqliteappcreate_app({TESTING:True,SQLALCHEMY_DATABASE_URI:fsqlite:///{db_file},})withapp.app_context():fromapp.extensionsimportdb db.create_all()returnapp.test_client()deftest_health(client):responseclient.get(/health)assertresponse.status_code200assertresponse.get_json()[service]flask-ledger运行python -m pytest -q时预期输出类似1 passed in 0.3s。如果出现sqlite3.OperationalError: unable to open database file先打印db_file的绝对路径确认父目录已经由tmp_path创建不要把数据库路径硬编码到项目根目录否则多次运行测试会互相污染。八、调试时应该观察什么flask --app run.py routes应看到/health。如果路由表为空问题在register_blueprint之前如果出现重复端点名通常是同一个蓝图被注册两次。调试配置时可临时执行appcreate_app({TESTING:True})print(app.config[SQLALCHEMY_DATABASE_URI])print([(rule.rule,sorted(rule.methods))forruleinapp.url_map.iter_rules()])不要把SECRET_KEY或数据库密码打印到日志线上排查应只打印bool(value)或经过掩码处理的主机名。本项目下一步会加入用户表因此本篇的健康检查故意不查询业务表让它只回答“进程是否活着”。九、本篇练习提交前自检新增GET /version返回{version: 0.1.0, python: 3.11}并在tests/test_app.py验证字段类型。为create_app增加instance/目录支持把 SQLite 文件放入 instance而不是源码目录。故意将蓝图注册写两次观察flask routes的异常再恢复为一次。完成后保留命令输出截图或终端文本。下一篇会逐项讲解环境配置、扩展初始化和蓝图拆分并把本篇的/version接口接入统一配置。本篇结束完整模块文件下面是交付项目中真实存在的完整文件 flask-ledger/app/init.py。它覆盖本篇新增逻辑以及前文已经完成的依赖代码复制单个函数会丢失上下文因此这里提供整份文件。fromflaskimportFlaskfrom.authimportbpasauth_bpfrom.extensionsimportdb,login_managerfrom.ledgerimportbpasledger_bpdefcreate_app(test_configNone):appFlask(__name__)app.config.from_mapping(SECRET_KEYdev-change-me,SQLALCHEMY_DATABASE_URIsqlite:///ledger.db,SQLALCHEMY_TRACK_MODIFICATIONSFalse,)iftest_config:app.config.update(test_config)db.init_app(app)login_manager.init_app(app)login_manager.unauthorized_handler(lambda:({message:请先登录},401))app.register_blueprint(auth_bp)app.register_blueprint(ledger_bp)app.get(/api/health)defhealth():return{status:ok}withapp.app_context():db.create_all()returnapp

零基础入门python19：Flask账本第一步——应用工厂、蓝图和健康检查

相关推荐

PCB板材TG150与TG170核心差异解析

LLM-Cookbook 学习——使用 LangChain 开发应用程序＞模型、提示模板与输出解析器 Models、Prompts and Output Parsers

设备出海非洲却频频掉线？选对物联网卡才能让业务跑起来

更多资讯

全球化采购管理系统的核心架构与实施策略

2026财务智能体市场解析与选型指南

EMD+PSO_SVM混合模型在大坝变形预测中的应用

VC6.0在Win7/Win10添加文件失效与FileTool.dll修复

光伏功率预测在极端天气下的挑战与解决方案

Scikit-learn模型评估：从基础指标到实战应用

今日更新

AI智能体开发实战：从技术原理到商业落地

OpenShell 完全定制指南：从安装到深度配置，打造高效 Windows 开始菜单

Superpowers技能体系全解析：从Skills引入到安装的完整指南

本周精选

防幻觉智能体架构：电源硬件设计中的大模型编排与工具化实践

OpenGL面试核心考点：渲染管线、矩阵变换与性能排查全解析

全国计算机二级C语言真题PDF高效刷题指南

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？